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)

XHPGetExtEventMask(3X)													    XHPGetExtEventMask(3X)

NAME

       XHPGetExtEventMask - Get an extension event mask.

SYNOPSIS

       int XHPGetExtEventMask (display, event_constant, event_type, event_mask)
	    Display *display;
	    long event_constant;
	    long *event_type;	     /* RETURN */
	    Mask *event_mask;	     /* RETURN */

ARGUMENTS

       display	   Specifies the connection to the X server.

       event_constant
		   Specifies the constant corresponding to the desired event.

       event_type  Specifies the address of a variable in which the server can return the event type of the desired event.

       event_mask  Specifies the address of a variable in which the server can return the event mask for the desired event.

DESCRIPTION

       This request is provided to support the use of input devices other than the X pointer device and X keyboard device.

       This request is part of an HP-proprietary extension to X.  Its functionality has been superseded by macros defined in the standard X input
       device extension header file XInput.h.  You should use the standard input device extension instead of XHPGetExtEventMask if possible.

       XHPGetExtEventMask is used by client programs to determine the event mask to be used in selecting extended events.  The request passes a
       constant to the server that corresponds to the desired event.  The server returns the event mask and event type for the desired event.

       Valid constants that may be used by the client to request corresponding event masks and types are:

       HPDeviceKeyPressreq
       HPDeviceKeyReleasereq
       HPDeviceButtonPressreq
       HPDeviceButtonReleasereq
       HPDeviceMotionNotifyreq
       HPDeviceFocusInreq
       HPDeviceFocusOutreq
       HPProximityInreq
       HPProximityOutreq
       HPDeviceKeymapNotifyreq

       For example, if an X system was configured with an extension key device, and a client program had determined the device ID of that device
       via XHPListInputDevices, and the client program wished to receive key presses from that device in window win, it would do the following:

       #include <XHPlib.h>

	    Display   display;
	    Window    win;
	    XID  deviceid;
	    long devicekeypresstype;
	    Mask devicekeypressmask;

	    (connection to the X server)
	    (determining the device id via XHPListInputDevices)

	    XHPGetExtEventMask (display, HPDeviceKeyPressreq,
		 &devicekeypresstype, &devicekeypressmask);

	    XHPSelectExtensionEvent (display, window, deviceid,
		 devicekeypressmask);

	    XNextEvent (display, &event);

	    if (event.type == devicekeypresstype)
		(process the event)

       BadEvent    The constant passed was not one of the valid constants.

RETURN VALUE

       Returns the mask if successful, -1 if failed.

FILES

       none

ORIGIN

       Hewlett-Packard Company

SEE ALSO

       XHPListInputDevices(3x)
       XHPSelectExtensionEvent(3x)
       XHPGetCurrentDeviceMask(3x)

X Version 11							     Release 5						    XHPGetExtEventMask(3X)