2
.\" $XFree86: xc/doc/man/Xi/XChgPtr.man,v 1.2 2001/01/27 18:20:21 dawes Exp $
5
.\" Copyright ([\d,\s]*) by Hewlett-Packard Company, Ardent Computer,
7
.\" Permission to use, copy, modify, distribute, and sell this documentation
8
.\" for any purpose and without fee is hereby granted, provided that the above
9
.\" copyright notice and this permission notice appear in all copies.
10
.\" Ardent, and Hewlett-Packard make no representations about the
11
.\" suitability for any purpose of the information in this document. It is
12
.\" provided \`\`as is'' without express or implied warranty.
14
.\" $Xorg: XChgPtr.man,v 1.3 2000/08/17 19:41:56 cpqbld Exp $
15
.ds xL Programming With Xlib
16
.TH XChangePointerDevice __LIB_MAN_SUFFIX__ __xorgversion__ "X FUNCTIONS"
2
.\" Title: xchangepointerdevice
3
.\" Author: [FIXME: author] [see http://docbook.sf.net/el/author]
4
.\" Generator: DocBook XSL Stylesheets v1.74.3 <http://docbook.sf.net/>
6
.\" Manual: [FIXME: manual]
7
.\" Source: [FIXME: source]
10
.TH "XCHANGEPOINTERDEVICE" "libmansuffix" "10/02/2009" "[FIXME: source]" "[FIXME: manual]"
11
.\" -----------------------------------------------------------------
12
.\" * set default formatting
13
.\" -----------------------------------------------------------------
14
.\" disable hyphenation
16
.\" disable justification (adjust text to left margin only)
18
.\" -----------------------------------------------------------------
19
.\" * MAIN CONTENT STARTS HERE *
20
.\" -----------------------------------------------------------------
18
22
XChangePointerDevice \- change which device is the X pointer
21
Status XChangePointerDevice\^(\^Display *\fIdisplay\fP\^, XDevice
22
*\fIdevice\fP\^, int \fIxaxis\fP\^, int \fIyaxis\fP\^);
27
Specifies the connection to the X server.
30
Specifies the device to be used as the X pointer.
33
Specifies the axis of the device to be used as the X pointer x-axis.
36
Specifies the axis of the device to be used as the X pointer y-axis.
38
The \fIXChangePointerDevice\fP request causes the server to use the specified
39
device as the X pointer. The device must have been opened by the client via
40
\fIXOpenDevice\fP or a \fIBadDevice\fP error will result. The device must
41
support input class \fIValuators\fP or a \fIBadMatch\fP error will result.
42
If the implementation does not support use of the specified device as the
43
X pointer, a \fIBadDevice\fP error will result.
45
If the specified device is grabbed by another client, \fIAlreadyGrabbed\fP
46
is returned. If the specified device is frozen by a grab on another device,
47
\fIGrabFrozen\fP is returned.
48
If the request is successful, \fISuccess\fP is returned.
50
If the request succeeds,
51
a \fIChangeDeviceNotify\fP event is sent to all clients that have selected that
52
event. A \fIMappingNotify\fP event with request = \fIMappingPointer\fP is
54
The specified device becomes the X pointer, and
55
the old X pointer becomes accessible through the input extension
58
\fIXChangePointerDevice\fP can generate a \fIBadDevice\fP or a \fIBadMatch\fP
63
An invalid device was specified. The specified device does not exist, has
64
not been opened by this client via \fIXOpenInputDevice\fP, or is already
65
one of the core X input devices (pointer or keyboard). This error may also
66
occur if the server implementation does not support using the specified
67
device as the X pointer.
70
This error may occur if an \fIXChangePointerDevice\fP request was made
71
specifying a device that has less than two valuators, or specifying a
72
valuator index beyond the range supported by the device.
26
#include <X11/extensions/XInput\&.h>
30
Status XChangePointerDevice( Display *display,
38
Specifies the connection to the X server\&.
43
Specifies the device to be used as the X pointer\&.
48
Specifies the axis of the device to be used as the X
54
Specifies the axis of the device to be used as the X
63
The XChangePointerDevice request causes the server to use the
64
specified device as the X pointer\&. The device must have been
65
opened by the client via XOpenDevice or a BadDevice error will
66
result\&. The device must support input class Valuators or a
67
BadMatch error will result\&. If the implementation does not
68
support use of the specified device as the X pointer, a
69
BadDevice error will result\&.
79
If the specified device is grabbed by another client,
80
AlreadyGrabbed is returned\&. If the specified device is frozen
81
by a grab on another device, GrabFrozen is returned\&. If the
82
request is successful, Success is returned\&.
92
If the request succeeds, a ChangeDeviceNotify event is sent to
93
all clients that have selected that event\&. A MappingNotify
94
event with request = MappingPointer is sent to all clients\&. The
95
specified device becomes the X pointer, and the old X pointer
96
becomes accessible through the input extension protocol
107
XChangePointerDevice can generate a BadDevice or a BadMatch
120
An invalid device was specified\&. The specified device
121
does not exist, has not been opened by this client via
122
XOpenInputDevice, or is already one of the core X input
123
devices (pointer or keyboard)\&. This error may also occur
124
if the server implementation does not support using the
125
specified device as the X pointer\&.
136
This error may occur if an XChangePointerDevice request
137
was made specifying a device that has less than two
138
valuators, or specifying a valuator index beyond the
139
range supported by the device\&.
150
XChangeKeyboardDevice(libmansuffix)