Linux and UNIX Man Pages

Linux & Unix Commands - Search Man Pages

xtungrabkea(3) [hpux man page]

XtUngrabKey()															     XtUngrabKey()

Name
  XtUngrabKey - cancel a passive key grab.

Synopsis
  void XtUngrabKey(widget, keycode, modifiers)
	   Widget widget;
	   KeyCode keycode;
	   Modifiers modifiers;

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

  keycode   Specifies the keycode to be ungrabbed.

  modifiers Specifies the modifiers to be ungrabbed.

Availability
  Release 4 and later.

Description
  XtUngrabKey()  cancels  a  passive grab on the specified keycode/modifiers combination for widget w.	If w is realized, XtUngrabKey() calls
  XUngrabKey() specifying the widget's window as the ungrab window and passing the remaining argument unmodified.  If the widget is not real-
  ized XtUngrabKey() removes the deferred XtGrabKey() request, if any, for the specified widget, keycode and modifiers.

  The  keycode	argument is the keycode of the key you want to ungrab, or the special value AnyKey which is equivalent to issuing the request
  for all possible nonmodifier key codes.

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

  XtUngrabKey() has no effect on an active grab.

  See XtGrabKey() for more details on passive key grabs.

Usage
  Most applications will never need to issue a passive grab.  XtAddGrab() (called by XtPopup()) can be used to implement modal popups  inside
  an  application, and XtSetKeyboardFocus() can be used to redirect keyboard focus within an application.  Neither function actually issues a
  grab, and so does not interrupt event processing by other clients.

Structures
  The Modifiers and KeyCode types are defined as follows:

     typedef unsigned int Modifiers;
     typedef unsigned char KeyCode;

See Also
  XtAddGrab(1), XtGrabButton(1), XtGrabKey(1), XtGrabKeyboard(1), XtGrabPointer(1), XtSetKeyboardFocus(1), XtUngrabButton(1), XtUngrabKey-
  board(1), XtUngrabPointer(1).

Xt - Keyboard Handling														     XtUngrabKey()

Check Out this Related Man Page

XtGrabKey(3)							   XT FUNCTIONS 						      XtGrabKey(3)

NAME
XtGrabKey, XtUngrabKey, XtGrabKeyboard, XtUngrabKeyboard, XtGrabButton, XtUngrabButton, XtGrabPointer, XtUngrabPointer - manage grabs SYNTAX
void XtGrabKey(Widget widget, KeyCode keycode, Modifiers modifiers, Boolean owner_events, int pointer_mode, int keyboard_mode); void XtUngrabKey(Widget widget, KeyCode keycode, Modifiers modifiers); int XtGrabKeyboard(Widget widget, Boolean owner_events, int pointer_mode, int keyboard_mode, Time time); void XtUngrabKeyboard(Widget widget, Time time); void XtGrabButton(Widget widget, int button, Modifiers modifiers, Boolean owner_events, unsigned int event_mask, int pointer_mode, int key- board_mode, Window confine_to, Cursor cursor); void XtUngrabButton(Widget widget, KeyCode button, Modifiers modifiers); int XtGrabPointer(Widget widget, Boolean owner_events, unsigned int event_mask, int pointer_mode, int keyboard_mode, Window confine_to, Cursor cursor, Time time); void XtUngrabPointer(Widget widget, Time time); ARGUMENTS
widget Specifies the widget in whose window the grab will occur. Must be of class Core or a subclass thereof. keycode modifiers owner_events pointer_mode keyboard_mode time button confine_to cursor Specifies arguments to the associated Xlib function call. DESCRIPTION
XtGrabKey calls XGrabKey specifying the widget's window as the grab window if the widget is realized. The remaining arguments are exactly as for XGrabKey. If the widget is not realized, or is later unrealized, the call to XGrabKey will be performed (again) when the widget is realized and its window becomes mapped. In the future, if XtDispatchEvent is called with a KeyPress event matching the specified keycode and modifiers (which may be AnyKey or AnyModifier, respectively) for the widget's window, the Intrinsics will call XtUngrabKeyboard with the timestamp from the KeyPress event if either of the following conditions is true: o There is a modal cascade and the widget is not in the active subset of the cascade and the keyboard was not previously grabbed, or o XFilterEvent returns True. XtUngrabKey calls XUngrabKey specifying the widget's window as the ungrab window if the widget is realized. The remaining arguments are exactly as for XUngrabKey. If the widget is not realized, XtUngrabKey removes a deferred XtGrabKey request, if any, for the specified wid- get, keycode, and modifiers. If the specified widget is realized XtGrabKeyboard calls XGrabKeyboard specifying the widget's window as the grab window. The remaining arguments and return value are exactly as for XGrabKeyboard. If the widget is not realized, XtGrabKeyboard immediately returns Grab- NotViewable. No future ungrab is implied by XtGrabKeyboard. XtUngrabKeyboard calls XUngrabKeyboard with the specified time. XtGrabButton calls XGrabButton specifying the widget's window as the grab window if the widget is realized. The remaining arguments are exactly as for XGrabButton. If the widget is not realized, or is later unrealized, the call to XGrabButton will be performed (again) when the widget is realized and its window becomes mapped. In the future, if XtDispatchEvent is called with a ButtonPress event matching the specified button and modifiers (which may be AnyButton or AnyModifier, respectively) for the widget's window, the Intrinsics will call XtUngrabPointer with the timestamp from the ButtonPress event if either of the following conditions is true: o There is a modal cascade and the widget is not in the active subset of the cascade and the pointer was not previously grabbed, or o XFilterEvent returns True. XtUngrabButton calls XUngrabButton specifying the widget's window as the ungrab window if the widget is realized. The remaining arguments are exactly as for XUngrabButton. If the widget is not realized, XtUngrabButton removes a deferred XtGrabButton request, if any, for the specified widget, button, and modifiers. XtGrabPointer calls XGrabPointer specifying the widget's window as the grab window. The remaining arguments and return value are exactly as for XGrabPointer. If the widget is not realized, XtGrabPointer immediately returns GrabNotViewable. No future ungrab is implied by XtGrabPointer. XtUngrabPointer calls XUngrabPointer with the specified time. SEE ALSO
X Toolkit Intrinsics - C Language Interface Xlib - C Language X Interface X Version 11 libXt 1.1.3 XtGrabKey(3)
Man Page