XHPSetInputDevice(3X) — X Version 11

Release 5

NAME

XHPSetInputDevice - Open a device for X input.

SYNOPSIS

#include <X11/XHPlib.h>
int XHPSetInputDevice (display, deviceid, mode)
Display*display;
XIDdeviceid;
intmode;

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

Museum

Related Articles