Manual Pages for UNIX Operating System command usage for man XtGrabButton

XT FUNCTIONS                                       XtGrabKey(3xt)



NAME
     XtGrabKey, XtUngrabKey, XtGrabKeyboard, XtUngrabKeyboard,
     XtGrabButton, XtUngrabButton, XtGrabPointer, XtUngrabPointer
     - manage grabs

SYNTAX
     cc [ flag... ] file... -lXt [ library... ]

     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.





X Version 11        Last change: libXt 1.0.8                    1






XT FUNCTIONS                                       XtGrabKey(3xt)



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, 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:

     +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 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,
     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 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:

     +o  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



X Version 11        Last change: libXt 1.0.8                    2






XT FUNCTIONS                                       XtGrabKey(3xt)



     +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 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


ATTRIBUTES
     See attributes(5) for descriptions of the following attri-
     butes:

     __________________________________________________________________
    |       ATTRIBUTE TYPE        |          ATTRIBUTE VALUE          |
    |_____________________________|___________________________________|
    | Availability                | x11/library/toolkit/libxt         |
    |_____________________________|___________________________________|
    | Interface Stability         | Committed                         |
    |_____________________________|___________________________________|
    | MT-Level                    | See XtToolkitThreadInitialize(3XT)|
    |_____________________________|___________________________________|



















X Version 11        Last change: libXt 1.0.8                    3