NAME¶
XWarpPointer - move pointer
SYNTAX¶
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);
ARGUMENTS¶
- dest_w
- Specifies the destination window or None.
- dest_x
-
- dest_y
- Specify the x and y coordinates within the destination
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 origin 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 position to 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 the pointer as far as the closest edge of the
confine_to window.
XWarpPointer can generate a
BadWindow error.
DIAGNOSTICS¶
- BadWindow
- A value for a Window argument does not name a defined
Window.
SEE ALSO¶
XSetInputFocus(3)
Xlib - C Language X Interface
