2 .\" Title: xchangepointerdevice
3 .\" Author: [FIXME: author] [see http://docbook.sf.net/el/author]
4 .\" Generator: DocBook XSL Stylesheets v1.76.1 <http://docbook.sf.net/>
6 .\" Manual: [FIXME: manual]
7 .\" Source: [FIXME: source]
10 .TH "XCHANGEPOINTERDEVICE" "libmansuffix" "09/23/2011" "[FIXME: source]" "[FIXME: manual]"
11 .\" -----------------------------------------------------------------
12 .\" * Define some portability stuff
13 .\" -----------------------------------------------------------------
14 .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
15 .\" http://bugs.debian.org/507673
16 .\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
17 .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
20 .\" -----------------------------------------------------------------
21 .\" * set default formatting
22 .\" -----------------------------------------------------------------
23 .\" disable hyphenation
25 .\" disable justification (adjust text to left margin only)
27 .\" -----------------------------------------------------------------
28 .\" * MAIN CONTENT STARTS HERE *
29 .\" -----------------------------------------------------------------
31 XChangePointerDevice \- change which device is the X pointer
35 #include <X11/extensions/XInput\&.h>
39 Status XChangePointerDevice( Display *display,
47 Specifies the connection to the X server\&.
52 Specifies the device to be used as the X pointer\&.
57 Specifies the axis of the device to be used as the X
63 Specifies the axis of the device to be used as the X
72 The XChangePointerDevice request causes the server to use the
73 specified device as the X pointer\&. The device must have been
74 opened by the client via XOpenDevice or a BadDevice error will
75 result\&. The device must support input class Valuators or a
76 BadMatch error will result\&. If the implementation does not
77 support use of the specified device as the X pointer, a
78 BadDevice error will result\&.
88 If the specified device is grabbed by another client,
89 AlreadyGrabbed is returned\&. If the specified device is frozen
90 by a grab on another device, GrabFrozen is returned\&. If the
91 request is successful, Success is returned\&.
101 If the request succeeds, a ChangeDeviceNotify event is sent to
102 all clients that have selected that event\&. A MappingNotify
103 event with request = MappingPointer is sent to all clients\&. The
104 specified device becomes the X pointer, and the old X pointer
105 becomes accessible through the input extension protocol
116 XChangePointerDevice can generate a BadDevice or a BadMatch
129 An invalid device was specified\&. The specified device
130 does not exist, has not been opened by this client via
131 XOpenInputDevice, or is already one of the core X input
132 devices (pointer or keyboard)\&. This error may also occur
133 if the server implementation does not support using the
134 specified device as the X pointer\&.
145 This error may occur if an XChangePointerDevice request
146 was made specifying a device that has less than two
147 valuators, or specifying a valuator index beyond the
148 range supported by the device\&.
159 XChangeKeyboardDevice(libmansuffix)