table of contents
XtGrabKey(3) | XT FUNCTIONS | XtGrabKey(3) |
NAME¶
XtGrabKey, XtUngrabKey, XtGrabKeyboard, XtUngrabKeyboard, XtGrabButton, XtUngrabButton, XtGrabPointer, XtUngrabPointer - manage grabsSYNTAX¶
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 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:- •
- 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.
- •
- 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
- •
- XFilterEvent returns True.
SEE ALSO¶
X Toolkit Intrinsics - C Language InterfacelibXt 1.1.4 | X Version 11 |