XQUERYDEVICEPOINTER(3) libXi XQUERYDEVICEPOINTER(3)NAMEXQueryDevicePointer - get device pointer coordinates.
SYNTAX
#include <X11/extensions/XInput.h>
Bool XQueryDevicePointer(Display *display, XDevice *device, Window win,
Window *root_return, Window *child_return,
int *root_x_return, int *root_y_return,
int *win_x_return, int *win_y_return,
unsigned int *mask_return);
ARGUMENTS
child_return
Returns the child window that the pointer is located in, if any.
device
Specifies the device to query.
display
Specifies the connection to the X server.
mask_return
Returns the current state of the modifier keys and pointer buttons.
root_return
Returns the root window that the pointer is in.
root_x_return, root_y_return
Return the pointer coordinates relative to the root window's origin.
win
Specifies the window.
win_x_return, win_y_return
Return the pointer coordinates relative to the specified window.
DESCRIPTION
The XQueryDevicePointer function returns the root window the device's
pointer is logically on and the pointer coordinates relative to the
root window's origin. If XQueryDevicePointer returns False, the pointer
is not on the same screen as the specified window, and
XQueryDevicePointer returns None to child_return and zero to
win_x_return and win_y_return. If XQueryDevicePointer returns True, the
pointer coordinates returned to win_x_return and win_y_return are
relative to the origin of the specified window. In this case,
XQueryDevicePointer returns the child that contains the pointer, if
any, or else None to child_return.
XQueryDevicePointer returns the current logical state of the keyboard
buttons and the modifier keys in mask_return. The keyboard paired with
the master pointer is selected to obtain this data. It sets mask_return
to the bitwise inclusive OR of one or more of the button or modifier
key bitmasks to match the current state of the mouse buttons and the
modifier keys.
XQueryDevicePointer is identical to XQueryPointer but specifies the
device explicitly.
XQueryDevicePointer can generate a BadDevice and a BadWindow error.
DIAGNOSIS
BadDevice
An invalid device was specified. The device does not exist or is not
a pointer device.
BadWindow
A value for a Window argument does not name a defined window.
SEE ALSO
XQueryPointer
AUTHOR
Peter Hutterer
Specification and implementation.
February 14, 2008 XQUERYDEVICEPOINTER(3)