MirOS Manual: XtGrabButton(3), XtGrabKey(3), XtGrabKeyboard(3), XtGrabPointer(3), XtUngrabButton(3), XtUngrabKey(3), XtUngrabKeyboard(3), XtUngrabPointer(3)


XtGrabKey(3Xt)            XT FUNCTIONS             XtGrabKey(3Xt)

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 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 func-
               tion call.

DESCRIPTION

     XtGrabKey calls XGrabKey specifying the widget's window as
     the grab window if the widget is realized. The remaining

XFree86                   Version 4.5.0                         1

XtGrabKey(3Xt)            XT FUNCTIONS             XtGrabKey(3Xt)

     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, respec-
     tively) 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:

     +  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

     +  XFilterEvent returns True.

     XtUngrabKey calls XUngrabKey specifying the widget's window
     as the ungrab window if the widget is realized. The remain-
     ing arguments are exactly as for XUngrabKey. If the widget
     is not realized, XtUngrabKey removes a deferred XtGrabKey
     request, if any, for the specified widget, 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, XtGrab-
     Keyboard immediately returns GrabNotViewable. No future
     ungrab is implied by XtGrabKeyboard.

     XtUngrabKeyboard calls XUngrabKeyboard with the specified
     time.

     XtGrabButton calls XGrabButton specifying the widget's win-
     dow 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:

     +  There is a modal cascade and the widget is not in the
        active subset of the cascade and the pointer was not pre-
        viously grabbed, or

     +  XFilterEvent returns True.

XFree86                   Version 4.5.0                         2

XtGrabKey(3Xt)            XT FUNCTIONS             XtGrabKey(3Xt)

     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, but-
     ton, 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 GrabNot-
     Viewable. 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

XFree86                   Version 4.5.0                         3

Generated on 2017-04-03 16:26:17 by $MirOS: src/scripts/roff2htm,v 1.88 2017/01/29 00:51:06 tg Exp $

These manual pages and other documentation are copyrighted by their respective writers; their source is available at our CVSweb, AnonCVS, and other mirrors. The rest is Copyright © 2002–2017 The MirOS Project, Germany.
This product includes material provided by mirabilos.

This manual page’s HTML representation is supposed to be valid XHTML/1.1; if not, please send a bug report — diffs preferred.