xungrabbutton(3x) [hpux man page]

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()

XtUngrabButton()														  XtUngrabButton()

Name
  XtUngrabButton - cancel a passive button grab.

Synopsis
  void XtUngrabButton(widget, button, modifiers)
	   Widget widget;
	   unsigned int button;
	   Modifiers modifiers;

Inputs
  widget    Specifies the widget in whose window the button was grabbed.

  button    Specifies the mouse button to be ungrabbed.

  modifiers Specifies the modifier keys to be ungrabbed.

Availability
  Release 4 and later.

Description
  XtUngrabButton()  cancels  a passive grab of the specified button/modifiers combination.  If w is realized, XtUngrabButton() calls XUngrab-
  Button() specifying the widget's window as the ungrab window, and passing the remaining arguments unmodified.  If the widget is  not	real-
  ized, XtUngrabButton() removes the deferred XtGrabButton() request, if any, for the specified widget, button, and modifiers.

  The  button  argument  is one of Button1, Button2, Button3, Button4, Button5, or the constant AnyButton, which is equivalent to issuing the
  ungrab request for all possible buttons.

  The modifiers argument is a bitwise OR of one or more of the following  symbols:  ShiftMask,	LockMask,  ControlMask,  Mod1Mask,  Mod2Mask,
  Mod3Mask,  Mod4Mask,	Mod5Mask.  The special value AnyModifier is also allowed; using it is equivalent to issuing the ungrab button request
  for all possible modifier combinations (including no modifiers).

  XtUngrabButton() has no effect on an active grab.

  See XtGrabButton() for more information on passive button grabs.

Usage
  You should rarely need to use passive button grabs.  An automatic grab takes place between a ButtonPress event and the  corresponding  But-
  tonRelease  event,  so  an  explicit	grab  is not necessary in some of the most common situations.  It may be necessary for some styles of
  menus, however.

  Note that XtAddGrab() and spring-loaded popups can be used in place of passive grabs in many circumstances.  These do  not  actually	issue
  any X server grabs.

Structures
  The Modifiers type is defined as follows:

     typedef unsigned int Modifiers;

See Also
  XtAddGrab(1), XtGrabButton(1), XtGrabKey(1), XtGrabKeyboard(1), XtGrabPointer(1), XtUngrabKey(1), XtUngrabKeyboard(1), XtUngrabPointer(1).

Xt - Mouse Handling														  XtUngrabButton()