www.LinuxHowtos.org
xcb_warp_pointer
Section: XCB Requests (3)Updated: libxcb 1.12
Index Return to Main Contents
NAME
xcb_warp_pointer - move mouse pointerSYNOPSIS
#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?