Unix/Linux Go Back    


X11R7.4 - man page for xtgrabkeyboard (x11r4 section 3)

Linux & Unix Commands - Search Man Pages
Man Page or Keyword Search:   man
Select Man Page Set:       apropos Keyword Search (sections above)


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 key-
	      board_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 keyboard_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 speci-
       fied widget, keycode, and modifiers.

       If the specified widget is realized XtGrabKeyboard calls XGrabKeyboard specifying the wid-
       get'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
       GrabNotViewable.  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 XtDis-
       patchEvent 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 Intrin-
       sics 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.0.5				     XtGrabKey(3)
Unix & Linux Commands & Man Pages : ©2000 - 2018 Unix and Linux Forums


All times are GMT -4. The time now is 01:11 PM.