1XCHANGEPOINTERDEVICE(libmansuffix)
2==================================
3
4NAME
5----
6
7   XChangePointerDevice - change which device is the X pointer
8
9SYNOPSIS
10--------
11
12   #include <X11/extensions/XInput.h>
13
14   Status XChangePointerDevice( Display *display,
15                                XDevice *device,
16                                int xaxis,
17                                int yaxis);
18
19   display
20          Specifies the connection to the X server.
21
22   device
23          Specifies the device to be used as the X pointer.
24
25   xaxis
26          Specifies the axis of the device to be used as the X
27          pointer x-axis.
28
29   yaxis
30          Specifies the axis of the device to be used as the X
31          pointer y-axis.
32
33DESCRIPTION
34-----------
35
36   The XChangePointerDevice request causes the server to use the
37   specified device as the X pointer. The device must have been
38   opened by the client via XOpenDevice or a BadDevice error will
39   result. The device must support input class Valuators or a
40   BadMatch error will result. If the implementation does not
41   support use of the specified device as the X pointer, a
42   BadDevice error will result.
43
44   If the specified device is grabbed by another client,
45   AlreadyGrabbed is returned. If the specified device is frozen
46   by a grab on another device, GrabFrozen is returned. If the
47   request is successful, Success is returned.
48
49   If the request succeeds, a ChangeDeviceNotify event is sent to
50   all clients that have selected that event. A MappingNotify
51   event with request = MappingPointer is sent to all clients. The
52   specified device becomes the X pointer, and the old X pointer
53   becomes accessible through the input extension protocol
54   requests.
55
56   XChangePointerDevice can generate a BadDevice or a BadMatch
57   error.
58
59DIAGNOSTICS
60-----------
61
62   BadDevice
63          An invalid device was specified. The specified device
64          does not exist, has not been opened by this client via
65          XOpenInputDevice, or is already one of the core X input
66          devices (pointer or keyboard). This error may also occur
67          if the server implementation does not support using the
68          specified device as the X pointer.
69
70   BadMatch
71          This error may occur if an XChangePointerDevice request
72          was made specifying a device that has less than two
73          valuators, or specifying a valuator index beyond the
74          range supported by the device.
75
76SEE ALSO
77--------
78
79   XChangeKeyboardDevice(libmansuffix)
80