XChangePointerDevice(3X11) X FUNCTIONS XChangePointerDevice(3X11)NAMEXChangePointerDevice - change which device is the X
pointer
SYNTAX
Status XChangePointerDevice(display, device xaxis, yaxis)
Display *display;
XDevice *device;
int xaxis;
int yaxis;
ARGUMENTS
display Specifies the connection to the X server.
device Specifies the device to be used as the X
pointer.
xaxis Specifies the axis of the device to be used as
the X pointer x-axis.
yaxis Specifies the axis of the device to be used as
the X pointer y-axis.
DESCRIPTION
The XChangePointerDevice request causes the server to use
the specified device as the X pointer. The device must
have been opened by the client via XOpenDevice or a BadDe-
vice error will result. The device must support input
class Valuators or a BadMatch error will result. If the
implementation does not support use of the specified
device as the X pointer, a BadDevice error will result.
If the specified device is grabbed by another client,
AlreadyGrabbed is returned. If the specified device is
frozen by a grab on another device, GrabFrozen is
returned. If the request is successful, Success is
returned.
If the request succeeds, a ChangeDeviceNotify event is
sent to all clients that have selected that event. A Map-
pingNotify event with request = MappingPointer is sent to
all clients. The specified device becomes the X pointer,
and the old X pointer becomes accessible through the input
extension protocol requests.
XChangePointerDevice can generate a BadDevice or a Bad-
Match error.
DIAGNOSTICS
BadDevice An invalid device was specified. The speci-
fied device does not exist, has not been
opened by this client via XOpenInputDevice, or
is already one of the core X input devices
(pointer or keyboard). This error may also
X Version 11 Release 6.4 1
XChangePointerDevice(3X11) X FUNCTIONS XChangePointerDevice(3X11)
occur if the server implementation does not
support using the specified device as the X
pointer.
BadMatch This error may occur if an XChangePointerDe-
vice request was made specifying a device that
has less than two valuators, or specifying a
valuator index beyond the range supported by
the device.
SEE ALSO
XChangeKeyboardDevice
Programming With Xlib
X Version 11 Release 6.4 2
