Release 5

NAME

XHPUngrabDevice - Release a grab of an extension input device. 

XHPUngrabDeviceButton - Release a passive grab of a button on an extension input device. 

XHPUngrabDeviceKey - Release a passive grab of a key on an extension input device. 

SYNOPSIS

int XHPUngrabDevice (display, deviceid, time)
Display*display;
XIDdeviceid;
Timetime;
 int XHPUngrabDeviceButton (display, deviceid, button, modifiers,
ungrab_window)
Display     *display;
XID            deviceid;
unsigned int   button;
unsigned int   modifiers;
Window         ungrab_window;
 int XHPUngrabDeviceKey (display, deviceid, keycode, modifiers,
ungrab_window)
Display        *display;
XID            deviceid;
unsigned int   keycode;
unsigned int   modifiers;
Window         ungrab_window;

ARGUMENTS

display Specifies the connection to the X server. 

deviceid Specifies the ID of a previously grabbed device. 

XHPUngrabDevice

time Specifies a timestamp, or CurrentTime. 

XHPUngrabDeviceButton

button Specifies the code of the button that is to be ungrabbed.  You can pass either a button or AnyButton. 

XHPUngrabDeviceKey

keycode Specifies the keycode of the key that is to be ungrabbed.  You can pass either the keycode or AnyKey. 

XHPUngrabDeviceButton and XHPUngrabDeviceKey Only

modifiers Specifies the set of keymasks.  This mask is the bitwise inclusive OR of these keymask bits:  ShiftMask, LockMask, ControlMask, Mod1Mask, Mod2Mask, Mod3Mask, Mod4Mask, Mod5Mask. 

You can also pass AnyModifier, which is equivalent to issuing the ungrab key request for all possible modifier combinations (including the combination of no modifiers). 

ungrab_window Specifies the ID of a window associated with the device specified above. 

DESCRIPTION

These requests are part of an HP-proprietary extension to X.  Their functionality has been superseded by standard X input device extension requests.  You should use XUngrabDevice instead of XHPUngrabDevice, XUngrabDeviceButton instead of XHPUngrabDeviceButton and XUngrabDeviceKey instead of XHPUngrabDeviceKey if possible. 

These requests are provided to support the use of input devices other than the X keyboard and X pointer device.  They allow a client to release a grab of an extended input device, or a button or key on such a device.  That grab must have previously been established using the corresponding grab request. 

XHPUngrabDevice

XHPUngrabDevice does not release the grab if the specified time is earlier than the last-device-grab time or is later than the current X server time.  It also generates DeviceFocusIn and DeviceFocusOut events.  The X server automatically performs an XHPUngrabDevice if the event window for an active device grab becomes not viewable. 

XHPUngrabDevice cannot be used to release a grab of the X pointer device or the X keyboard device.  The core XUngrabPointer and XUngrabKeyboard requests should be used for that purpose. 

XHPUngrabDeviceButton

The XHPUngrabDeviceButton request removes a passive grab of a button on an extension device.  A modifier of AnyModifier is equivalent to issuing the request for all possible modifier combinations (including the combination of no modifiers).  XHPUngrabDeviceButton can generate BadDevice and BadWindow errors. 

XHPUngrabDeviceButton cannot be used to ungrab a button on the X pointer device.  The core XUngrabButton request should be used for that purpose. 

XHPUngrabDeviceKey

The XHPUngrabDeviceKey request removes a passive grab of a key on an extension device.  A modifier of AnyModifier is equivalent to issuing the request for all possible modifier combinations (including the combination of no modifiers).  XHPUngrabDeviceKey can generate BadDevice and BadWindow errors. 

XHPUngrabDeviceKey cannot be used to ungrab a key on the X keyboard device.  The core XUngrabKey request should be used for that purpose. 

DIAGNOSTICS

BadDevice An invalid device ID was specified. 

BadWindow An invalid window ID was specified. 

RETURN VALUE

none

FILES

none

ORIGIN

Hewlett-Packard Company

SEE ALSO

XHPListInputDevices(3x)
XHPSetInputDevice(3x)
XHPGrabDevice(3x)
XHPGrabDeviceButton(3x)
XHPGrabDeviceKey(3x)
XUngrabKeyboard(3x)
XUngrabPointer(3x)
XUngrabButton(3x)
XUngrabKey(3x)

Hewlett-Packard Company  —  HP-UX 9.0 August 1992