WtPointer Function

Reference Guide > W Routines > WtPointer Function

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)