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
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:
+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
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 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 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 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 InterfaceX Version 11 libXt 1.1.5 XtGrabKey(3)