hpux man page for xhpgetexteventmask

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)