XtGrabKey(3Xt)XtGrabKey(3Xt)NAME
XtGrabKey, XtUngrabKey, XtGrabKeyboard, XtUngrabKeyboard, XtGrabButton,
XtUngrabButton, XtGrabPointer, XtUngrabPointer - manage grabs
SYNOPSIS
void XtGrabKey(widget, keycode, modifiers, owner_events, pointer_mode,
keyboard_mode)
Widget widget;
KeyCode keycode;
Modifiers modifiers;
Boolean owner_events;
int pointer_mode;
int keyboard_mode;
void XtUngrabKey(widget, keycode, modifiers)
Widget widget;
KeyCode keycode;
Modifiers modifiers;
int XtGrabKeyboard(widget, owner_events, pointer_mode, keyboard_mode,
time)
Widget widget;
Boolean owner_events;
int pointer_mode;
int keyboard_mode;
Time time;
void XtUngrabKeyboard(widget, time)
Widget widget;
Time time;
void XtGrabButton(widget, button, modifiers, owner_events, event_mask,
pointer_mode, keyboard_mode, confine_to, cursor)
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, button, modifiers)
Widget widget;
KeyCode button;
Modifiers modifiers;
int XtGrabPointer(widget, owner_events, event_mask, pointer_mode, key‐
board_mode, confine_to, cursor, time)
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, time)
Widget widget;
Time time;
ARGUMENTS
Specifies the widget in whose window the grab will occur. Must be of
class Core or a subclass thereof. Specifies arguments to the associ‐
ated 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 real‐
ized and its window becomes mapped. In the future, if XtDispatchEvent
is called with a KeyPress event matching the specified keycode and mod‐
ifiers (which may be AnyKey or AnyModifier, respectively) for the wid‐
get's window, the Intrinsics will call XtUngrabKeyboard with the time‐
stamp 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 sub‐
set 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 remaining 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 argu‐
ments 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
XtDispatchEvent is called with a ButtonPress event matching the speci‐
fied button and modifiers (which may be AnyButton or AnyModifier,
respectively) for the widget's window, the Intrinsics will call XtUn‐
grabPointer with the timestamp from the ButtonPress event if either of
the following conditions is true: There is a modal cascade and the wid‐
get is not in the active subset of the cascade and the pointer was not
previously grabbed, or 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, XtUn‐
grabButton 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 immedi‐
ately returns GrabNotViewable. No future ungrab is implied by XtGrab‐
Pointer.
XtUngrabPointer calls XUngrabPointer with the specified time.
SEE ALSO
X Toolkit Intrinsics -- C Language Interface
Xlib -- C Language X Interface
XtGrabKey(3Xt)