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

displaySpecifies a connection to an X server; returned from XOpenDisplay(). 

buttonSpecifies the mouse button to be released from grab.  Specify Button1, Button2, Button3, Button4, Button5, or the constant AnyButton, which is equivalent to issuing the ungrab request for all possible buttons. 

modifiersSpecifies 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 modifiers).  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

BadValueInvalid button or modifiers mask. 

See Also

XChangeActivePointerGrab(), XGrabButton(), XGrabKey(), XGrabKeyboard(), XGrabPointer(), XGrabServer(), XUngrabKey(), XUngrabKeyboard(), XUngrabPointer(), XUngrabServer(). 

Copyright O’Reilly & Assoc.  —