XHPUngrabDevice(3X) XHPUngrabDevice(3X)
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;
XID deviceid;
Time time;
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)
X Version 11 Release 5 XHPUngrabDevice(3X)