Man page or keyword search:   man All Sections 1 - General Commands 2 - System Calls 3 - Subroutines, Functions 4 - Special Files 5 - File Formats 6 - Games and Screensavers 7 - Macros and Conventions 8 - Maintenence Commands 9 - Kernel Interface New Commands Server 4.4BSD AIX Alpinelinux Archlinux Aros BSDOS BSDi Bifrost CentOS Cygwin Darwin Debian DigitalUNIX DragonFly ElementaryOS Fedora FreeBSD Gentoo GhostBSD HP-UX Haiku Hurd IRIX Inferno JazzOS Kali Knoppix LinuxMint MacOSX Mageia Mandriva Manjaro Minix MirBSD NeXTSTEP NetBSD OPENSTEP OSF1 OpenBSD OpenDarwin OpenIndiana OpenMandriva OpenServer OpenSuSE OpenVMS Oracle PC-BSD Peanut Pidora Plan9 QNX Raspbian RedHat Scientific Slackware SmartOS Solaris SuSE SunOS Syllable Tru64 UNIXv7 Ubuntu Ultrix UnixWare Xenix YellowDog aLinux   10987 pages apropos Keyword Search (all sections) Output format html ascii pdf view pdf save postscript

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/modi‐
  fiers combination.  If w is realized, XtUngrabButton()  calls	 XUngrab‐
  Button() specifying the widget's window as the ungrab window, and pass‐
  ing the remaining arguments unmodified.  If the widget is not realized,
  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,  But‐
  ton5,	 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 ButtonRe‐
  lease event, so an explicit grab is not necessary in some of	the  most
  common  situations.  It may be necessary for some styles of menus, how‐
  ever.

  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), XtGrab‐
  Pointer(1), XtUngrabKey(1), XtUngrabKeyboard(1), XtUngrabPointer(1).

Xt - Mouse Handling					      XtUngrabButton()

Vote for polarhome