XHPSetInputDevice(3X) XHPSetInputDevice(3X)
NAME
XHPSetInputDevice - Open a device for X input.
SYNOPSIS
#include <X11/XHPlib.h>
int XHPSetInputDevice (display, deviceid, mode)
Display *display;
XID deviceid;
int mode;
ARGUMENTS
display Specifies the connection to the X server.
deviceid Specifies the ID of the desired device.
mode Specifies the desired mode of access.
DESCRIPTION
This request is part of an HP-proprietary extension to X. Its functionality has been superseded by the standard X input device extension
XOpenDevice request. You should use XOpenDevice instead of XHPSetInputDevice if possible.
This request is provided to support input devices other than the X keyboard device and the X pointer device.
Client programs use the XHPSetInputDevice to open an input device for extended input and to close the device. XHPSetInputDevice requires a
mode parameter that specifies the request being requested (ON or OFF) and, if the request is ON, whether the device should be opened as an
extension to the X keyboard or pointer (SYSTEM_EVENTS), or as an independently selectable device (DEVICE_EVENTS). The value of the mode
parameter is set by ORing together the above constants, which may be obtained by including the file <X11/XHPlib.h>.
To open an input device as a device whose input can be selected independent of the X keyboard and X pointer, the client program would use
the mode ON OR'd with the mode DEVICE_EVENTS. To open an input device as an extension of the X keyboard or X pointer, the client program
would use the mode ON or'd with the mode SYSTEM_EVENTS. Valid values for the mode parameter are:
ON | SYSTEM_EVENTS
ON | DEVICE_EVENTS
OFF
This request will fail with a BadMode error if some other client is already using the device with a different mode.
DIAGNOSTICS
BadMode An invalid mode was specified.
BadDevice An invalid device ID was specified.
RETURN VALUE
none
FILES
/usr/include/X11/XHPlib.h
ORIGIN
Hewlett-Packard Company
SEE ALSO
XHPListInputDevices(3x)
XHPGetExtEventMask(3x)
XHPSelectExtensionEvent(3x)
X Version 11 Release 5 XHPSetInputDevice(3X)
