xhpacknowledge(3x) [hpux man page]

XHPAcknowledge(3X)														XHPAcknowledge(3X)

NAME

       XHPAcknowledge - Send an Acknowledge to an extended input device.

SYNOPSIS

       #include <X11/XHPlib.h>

       int XHPAcknowledge (display, deviceid, acknowledge)
	    Display	   *display;
	    XID       deviceid;
	    int       acknowledge;

ARGUMENTS

       display	   Specifies the connection to the X server.

       deviceid    Specifies the ID of the desired device.

       acknowledge Specifies the acknowledge to be sent.  Valid values are: GENERAL_ACKNOWLEDGE, ACKNOWLEDGE_1, ACKNOWLEDGE_2, ACKNOWLEDGE_3,
		   ACKNOWLEDGE_4, ACKNOWLEDGE_5, ACKNOWLEDGE_6, ACKNOWLEDGE_7.

DESCRIPTION

       This request is part of an HP-proprietary extension to X.  Its functionality has been superseded by the standard XChangeFeedbackControl
       request.  You should use XChangeFeedbackControl instead of XHPAcknowledge if possible.

       This request sends an acknowledge to an input device.  This allows a previously received prompt to be turned off.

       A prompt is an audio or visual indication that the program controlling the input device is ready for input.  The LED on an HP46086A
       buttonbox is an example of a prompt.  A program may indicate its status by turning on a prompt on the appropriate input device.

       Not all input devices support prompts and acknowledges.	Any device that does support a particular prompt will also support the
       corresponding acknowledge.

       To determine whether an input device supports a particular prompt and acknowledge, the io_byte field of the XHPDeviceList structure should
       be examined.  The format of this structure is described in the documentation for the XHPListInputDevices request.

RETURN VALUE

       none

DIAGNOSTICS

       BadDevice   An invalid device ID was specified.

       BadValue    An invalid acknowledge was specified.

FILES

       /usr/include/X11/XHPlib.h

ORIGIN

       Hewlett-Packard Company

SEE ALSO

       XHPListInputDevices(3x)
       XHPPrompt(3x)

X Version 11							     Release 5							XHPAcknowledge(3X)

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)