Series 300 and 800 Only

NAME

XHPGetExtEventMask - Get an extension event mask. 

SYNOPSIS

XHPGetExtEventMask (display, event_constant, event_type, event_mask)
Display ∗display;
longevent_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 function is provided to support the use of input devices other than the X pointer device and X keyboard device. 

XHPGetExtEventMask is used by client programs to determine the event mask to be used in selecting extended events.  The function 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>
 Displaydisplay;
Windowwin;
XIDdeviceid;
longdevicekeypresstype;
Maskdevicekeypressmask;
 (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)
 

DIAGNOSTICS

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

RETURN VALUE

none

FILES

none

ORIGIN

Hewlett-Packard Company

SEE ALSO

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