hpux man page for xhpsetinputdevice

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)