XLIB FUNCTIONS XWarpPointer(3x11)
NAME
XWarpPointer - move pointer
SYNTAXcc [ flag... ] file... -lX11 [ library... ]
int XWarpPointer(Display *display, Window src_w, Window
dest_w, int src_x, int src_y, unsigned int src_width,
unsigned int src_height, int dest_x, int dest_y);
ARGUMENTSdest_w Specifies the destination window or None.
dest_x
dest_y Specify the x and y coordinates within the desti-
nation window. display Specifies the connection to the X server.src_x
src_y
src_width
src_height
Specify a rectangle in the source window.src_w Specifies the source window or None.
DESCRIPTION
If dest_w is None, XWarpPointer moves the pointer by the
offsets (dest_x, dest_y) relative to the current position of
the pointer. If dest_w is a window, XWarpPointer moves the
pointer to the offsets (dest_x, dest_y) relative to the ori-
gin of dest_w. However, if src_w is a window, the move only
takes place if the window src_w contains the pointer and if
the specified rectangle of src_w contains the pointer.
The src_x and src_y coordinates are relative to the origin
of src_w. If src_height is zero, it is replaced with the
current height of src_w minus src_y. If src_width is zero,
it is replaced with the current width of src_w minus src_x.
There is seldom any reason for calling this function. The pointer should normally be left to the user. If you do use this function, however, it generates events just as if the user had instantaneously moved the pointer from one positionto another. Note that you cannot use XWarpPointer to move
the pointer outside the confine_to window of an active
pointer grab. An attempt to do so will only move thepointer as far as the closest edge of the confine_to window.
XWarpPointer can generate a BadWindow error.
X Version 11 Last change: libX11 1.3.5 1XLIB FUNCTIONS XWarpPointer(3x11)
DIAGNOSTICS BadWindow A value for a Window argument does not name a defined Window.SEE ALSO
XSetInputFocus(3x11)Xlib - C Language X Interface
ATTRIBUTES
See attributes(5) for descriptions of the following attri-
butes:____________________________________________________________
| ATTRIBUTE TYPE | ATTRIBUTE VALUE |
|_____________________________|_____________________________|
| Availability | x11/library/libx11 ||_____________________________|_____________________________|
| Interface Stability | Committed ||_____________________________|_____________________________|
| MT-Level | See XInitThreads(3X11) |
|_____________________________|_____________________________|
X Version 11 Last change: libX11 1.3.5 2