XUngrabButton() XUngrabButton()
Name
XUngrabButton - release a button from a passive grab.
Synopsis
XUngrabButton(display, button, modifiers, grab_window)
Display *display;
unsigned int button;
unsigned int modifiers;
Window grab_window;
Arguments
display Specifies a connection to an X server; returned from XOpenDisplay().
button Specifies the mouse button to be released from grab. Specify Button1, Button2, Button3, Button4, Button5, or the constant Any-
Button, which is equivalent to issuing the ungrab request for all possible buttons.
modifiers Specifies a set of keymasks. This is a bitwise OR of one or more of the following symbols: ShiftMask, LockMask, ControlMask,
Mod1Mask, Mod2Mask, Mod3Mask, Mod4Mask, Mod5Mask, or AnyModifier. AnyModifier is equivalent to issuing the ungrab button request
for all possible modifier combinations (including no modifiers).
grab_window
Specifies the ID of the window you want to release the button grab.
Description
XUngrabButton() cancels the passive grab on a button/key combination on the specified window if it was grabbed by this client. A modifiers
of AnyModifier is equivalent to issuing the ungrab request for all possible modifier combinations (including the combination of no modi-
fiers). A button of AnyButton is equivalent to issuing the request for all possible buttons. This call has no effect on an active grab.
For more information, see Volume One, Chapter 9, The Keyboard and Pointer.
Errors
BadWindow
BadValue Invalid button or modifiers mask.
See Also
XChangeActivePointerGrab(), XGrabButton(), XGrabKey(), XGrabKeyboard(), XGrabPointer(), XGrabServer(), XUngrabKey(), XUngrabKeyboard(),
XUngrabPointer(), XUngrabServer().
Xlib - Grabbing XUngrabButton()
