XWarpPointer(3) XLIB FUNCTIONS XWarpPointer(3)
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 mi-
nus 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, how-
ever, 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 ac-
tive 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
X Version 11 libX11 1.8.12 XWarpPointer(3)
Generated by dwww version 1.16 on Sat Oct 3 08:34:59 CEST 2026.