1XChangePointerDevice(3)           X FUNCTIONS          XChangePointerDevice(3)
2
3
4

NAME

6       XChangePointerDevice - change which device is the X pointer
7

SYNTAX

9       Status  XChangePointerDevice(Display  *display,  XDevice  *device,  int
10              xaxis, int yaxis);
11

ARGUMENTS

13       display     Specifies the connection to the X server.
14
15       device      Specifies the device to be used as the X pointer.
16
17       xaxis       Specifies the axis of the  device  to  be  used  as  the  X
18                   pointer x-axis.
19
20       yaxis       Specifies  the  axis  of  the  device  to  be used as the X
21                   pointer y-axis.
22

DESCRIPTION

24       The XChangePointerDevice request causes the server to use the specified
25       device  as  the  X  pointer.   The  device must have been opened by the
26       client via XOpenDevice or a BadDevice error will  result.   The  device
27       must support input class Valuators or a BadMatch error will result.  If
28       the implementation does not support use of the specified device as  the
29       X pointer, a BadDevice error will result.
30
31       If the specified device is grabbed by another client, AlreadyGrabbed is
32       returned.  If the specified device is  frozen  by  a  grab  on  another
33       device,  GrabFrozen is returned.  If the request is successful, Success
34       is returned.
35
36       If the request succeeds, a ChangeDeviceNotify  event  is  sent  to  all
37       clients  that  have  selected  that  event.  A MappingNotify event with
38       request = MappingPointer is sent to all clients.  The specified  device
39       becomes the X pointer, and the old X pointer becomes accessible through
40       the input extension protocol requests.
41
42       XChangePointerDevice can generate a BadDevice or a BadMatch error.
43

DIAGNOSTICS

45       BadDevice   An invalid device was specified.  The specified device does
46                   not  exist, has not been opened by this client via XOpenIn‐
47                   putDevice, or is already one of the core  X  input  devices
48                   (pointer  or  keyboard).   This error may also occur if the
49                   server implementation does not support using the  specified
50                   device as the X pointer.
51
52       BadMatch    This error may occur if an XChangePointerDevice request was
53                   made specifying a device that has less than two  valuators,
54                   or  specifying  a valuator index beyond the range supported
55                   by the device.
56

SEE ALSO

58       XChangeKeyboardDevice
59       Programming With Xlib
60
61
62
63X Version 11                      libXi 1.1.1          XChangePointerDevice(3)
Impressum