xcb_warp_pointer - Man Page

move mouse pointer

Synopsis

#include <xcb/xproto.h>

Request function

xcb_void_cookie_t xcb_warp_pointer(xcb_connection_t *conn, xcb_window_t src_window, xcb_window_t dst_window, int16_t src_x, int16_t src_y, uint16_t src_width, uint16_t src_height, int16_t dst_x, int16_t dst_y);

Request Arguments

conn

The XCB connection to X11.

src_window

If src_window is not XCB_NONE (TODO), the move will only take place if the pointer is inside src_window and within the rectangle specified by (src_x, src_y, src_width, src_height). The rectangle coordinates are relative to src_window.

dst_window

If dst_window is not XCB_NONE (TODO), the pointer will be moved to the offsets (dst_x, dst_y) relative to dst_window. If dst_window is XCB_NONE (TODO), the pointer will be moved by the offsets (dst_x, dst_y) relative to the current position of the pointer.

src_x

TODO: NOT YET DOCUMENTED.

src_y

TODO: NOT YET DOCUMENTED.

src_width

TODO: NOT YET DOCUMENTED.

src_height

TODO: NOT YET DOCUMENTED.

dst_x

TODO: NOT YET DOCUMENTED.

dst_y

TODO: NOT YET DOCUMENTED.

Description

Moves the mouse pointer to the specified position.

If src_window is not XCB_NONE (TODO), the move will only take place if the pointer is inside src_window and within the rectangle specified by (src_x, src_y, src_width, src_height). The rectangle coordinates are relative to src_window.

If dst_window is not XCB_NONE (TODO), the pointer will be moved to the offsets (dst_x, dst_y) relative to dst_window. If dst_window is XCB_NONE (TODO), the pointer will be moved by the offsets (dst_x, dst_y) relative to the current position of the pointer.

Return Value

Returns an xcb_void_cookie_t. Errors (if any) have to be handled in the event loop.

If you want to handle errors directly with xcb_request_check instead, use xcb_warp_pointer_checked. See xcb-requests(3) for details.

Errors

xcb_window_error_t

TODO: reasons?

See Also

xcb-requests(3), xcb_set_input_focus(3)

Author

Generated from xproto.xml. Contact xcb@lists.freedesktop.org for corrections and improvements.

Referenced By

The man page xcb_warp_pointer_checked(3) is an alias of xcb_warp_pointer(3).

libxcb 1.17.0 X Version 11 XCB Requests