XSETCLIENTPOINTER, X(3) libXi XSETCLIENTPOINTER, X(3)NAME
XSetClientPointer, XGetClientPointer - set or get the ClientPointer
setting.
SYNTAX
#include <X11/extensions/XInput.h>
XSetClientPointer(Display *display, Window win, XDevice *device);
Bool XGetClientPointer(Display *display, Window win, XID *device);
ARGUMENTS
display
Specifies the connection to the X server.
win
Specifies a window belonging to the client. May be None.
device
Specifies the device to set as ClientPointer.
DESCRIPTION
The ClientPointer is the device that is percieved to be the core
pointer for non-XI protocol requests and replies. Each time a protocol
message needs device-dependent data and the device is not explicitly
given, the ClientPointer device is used to obtain the data. For
example, a XQueryPointer request will return the coordinates of the
ClientPointer.
XSetClientPointer request sets the ClientPointer device for the client
that owns the given window. If win is None, the requesting client's
ClientPointer is set to the device. Only master pointer devices can be
set as ClientPointer.
XSetClientPointer and can generate a BadDevice and a BadWindow error.
The XGetClientPointer request returns the ClientPointer's device ID for
the client that owns the given window. If win is None, the requesting
client's ClientPointer is returned.
win may be a client ID instead of a window.
XGetClientPointer can generate a BadWindow error.
DIAGNOSIS
BadDevice
An invalid device was specified. The device does not exist or is not
a master pointer device.
BadWindow
A value for a Window argument does not name a defined window.
AUTHOR
Peter Hutterer
Specification and implementation.
February 14, 2008 XSETCLIENTPOINTER, X(3)