XSetDeviceValuators
Section: X FUNCTIONS (3X11)
Updated: Release 5
Index
Return to Main Contents
NAME
XSetDeviceValuators - initialize the valuators on an extension input device
SYNTAX
XSetDeviceValuators(display, device, valuators, first_valuator, num_valuators)
Display *display;
XDevice *device;
int *valuators;
int first_valuator;
int num_valuators;
ARGUMENTS
- display
-
Specifies the connection to the X server.
- device
-
Specifies the device whose valuators are to be initialized.
- valuators
-
Specifies a pointer to an array of integer values to be used to initialize the
device valuators.
- first_valuator
-
Specifies the first valuator to be set. Valuators are numbered beginning with
zero.
- num_valuators
-
Specifies the number of valuators to be set.
DESCRIPTION
The
XSetDeviceValuators
request sets the current values of the valuators of an input device.
The valuators in the range
first_valuator to (first_valuator + num_valuators)
are set to the specified values. Valuators are numbered beginning with 0.
Not all input devices support initialization of valuator values. If this
request is made to a device that does not support valuators initialization,
a BadMatch error will occur.
If the request succeeds, a status of Success is returned. If another
client has the device grabbed, a status of AlreadyGrabbed is returned.
XSetDeviceValuators
can generate a BadLength, BadDevice , BadMatch, or
BadValue error.
DIAGNOSTICS
- BadDevice
-
An invalid device was specified. The specified device does not exist or has
not been opened by this client via XOpenInputDevice.
- BadMatch
-
This error may occur if an XSetDeviceValuators request is made
specifying a device that has no valuators and reports no axes of motion,
or if such a request is made specifying a device that does not support
valuator initialization.
- BadValue
-
An invalid first_valuator or num_valuators values was specified.
SEE ALSO
Programming with Xlib
Index
- NAME
-
- SYNTAX
-
- ARGUMENTS
-
- DESCRIPTION
-
- DIAGNOSTICS
-
- SEE ALSO
-
This document was created by
man2html,
using the manual pages.
Time: 07:02:35 GMT, May 19, 2025