man-pages/man3/XSetDeviceValuators.3.html
2021-03-31 01:06:50 +01:00

209 lines
3.3 KiB
HTML

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<HTML><HEAD><TITLE>Man page of XSETDEVICEVALUATORS</TITLE>
</HEAD><BODY>
<H1>XSETDEVICEVALUATORS</H1>
Section: &nbsp; (3)<BR>Updated: 06/19/2019<BR><A HREF="#index">Index</A>
<A HREF="/cgi-bin/man/man2html">Return to Main Contents</A><HR>
<A NAME="lbAB">&nbsp;</A>
<H2>NAME</H2>
XSetDeviceValuators - initialize the valuators on an extension input device
<A NAME="lbAC">&nbsp;</A>
<H2>SYNOPSIS</H2>
<P>
<PRE>
#include &lt;<A HREF="file:///usr/include/X11/extensions/XInput.h">X11/extensions/XInput.h</A>&gt;
</PRE>
<P>
<PRE>
XSetDeviceValuators( Display *display,
XDevice *device,
int *valuators,
int first_valuator,
int num_valuators);
</PRE>
<P>
<PRE>
display
Specifies the connection to the X server.
</PRE>
<P>
<PRE>
device
Specifies the device whose valuators are to be
initialized.
</PRE>
<P>
<PRE>
valuators
Specifies a pointer to an array of integer values to be
used to initialize the device valuators.
</PRE>
<P>
<PRE>
first_valuator
Specifies the first valuator to be set. Valuators are
numbered beginning with zero.
</PRE>
<P>
<PRE>
num_valuators
Specifies the number of valuators to be set.
</PRE>
<A NAME="lbAD">&nbsp;</A>
<H2>DESCRIPTION</H2>
<P>
<DL COMPACT><DT id="1"><DD>
<PRE>
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.
</PRE>
</DL>
<P>
<DL COMPACT><DT id="2"><DD>
<PRE>
If the request succeeds, a status of Success is returned. If
another client has the device grabbed, a status of
AlreadyGrabbed is returned.
</PRE>
</DL>
<P>
<DL COMPACT><DT id="3"><DD>
<PRE>
XSetDeviceValuators can generate a BadLength, BadDevice,
BadMatch, or BadValue error.
</PRE>
</DL>
<A NAME="lbAE">&nbsp;</A>
<H2>DIAGNOSTICS</H2>
<P>
<DL COMPACT><DT id="4"><DD>
<PRE>
BadDevice
An invalid device was specified. The specified device
does not exist or has not been opened by this client via
XOpenInputDevice.
</PRE>
</DL>
<P>
<DL COMPACT><DT id="5"><DD>
<PRE>
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.
</PRE>
</DL>
<P>
<DL COMPACT><DT id="6"><DD>
<PRE>
BadValue
An invalid first_valuator or num_valuators values was
specified.
</PRE>
</DL>
<P>
<HR>
<A NAME="index">&nbsp;</A><H2>Index</H2>
<DL>
<DT id="7"><A HREF="#lbAB">NAME</A><DD>
<DT id="8"><A HREF="#lbAC">SYNOPSIS</A><DD>
<DT id="9"><A HREF="#lbAD">DESCRIPTION</A><DD>
<DT id="10"><A HREF="#lbAE">DIAGNOSTICS</A><DD>
</DL>
<HR>
This document was created by
<A HREF="/cgi-bin/man/man2html">man2html</A>,
using the manual pages.<BR>
Time: 00:06:01 GMT, March 31, 2021
</BODY>
</HTML>