WtPointer Function

The pointer utility function.

Usage

status = WtPointer(function, widget[, parameters])

Parameters

function:

'GetLocation' — Get the current location of the pointer.

'GetControl' — (Motif only) Get the control attributes of the pointer.

'GetMapping' — (Motif only) Get the current mapping of the pointer.

'SetLocation' — (Motif only) Set the location of the pointer.

'SetControl' — (Motif only) Set the control attributes of the pointer.

'SetMapping' — (Motif only) Set the mapping of the pointer.

widget — The current widget.

parameters:

'GetLocation' — A seven-element array of long integers:

0 — Root window

1 — Child window where the pointer is located

2 — X coordinate in root

3 — Y coordinate in root

4 — X coordinate in current window

5 — Y coordinate in current window

6 — Modifier keys and buttons state mask

'GetControl' — A three-element array of long integers:

0 — accel_numerator

1 — accel_denominator

2 — threshold

'GetMapping' — An array of up to ten long integers:

0–9 — Pointer button mapping

'SetLocation' — A two element array of long integers:

0 — X coordinate in current window

1 — Y coordinate in current window

'SetControl' — A three-element array of long integers:

0 — accel_numerator

1 — accel_denominator

2 — threshold

'SetMapping' — An array of up to ten long integers:

0–9 — Pointer button mapping

Returned Value

status — One (1) indicates success; zero (0) indicates failure.

Discussion

See the Xlib Reference Manual (O'Reilly & Associates, Inc., 1989) for details on XQueryPointer, XGetPointerControl, XGetPointerMapping, XWarpPointer, XChangePointerControl, and XSetPointerMapping.

Note:

Rogue Wave has ported a subset of the Widget Toolbox (Wt) functionality that is available for Motif to Microsoft Windows. Because the Widget Toolbox under Windows is not a complete implementation, we recommend that Windows developers use the PV‑WAVE Widgets (Ww) layer or the VDA Tools when developing GUI applications.

Example

.
.
status=WtPointer("GetLocation", wid, state)
.
.

See Also

For detailed information on GUI development, refer to the PV‑WAVE Application Developer’s Guide.

For more information about how to write an application program based on the PV‑WAVE Widget Toolbox, refer to Using the Widget Toolbox in the PV‑WAVE Application Developer’s Guide.