Name

XtGrabKeyboard — actively grab the keyboard. 

Synopsis

int XtGrabKeyboard(widget, owner_events, pointer_mode, keyboard_mode, time)

      Widget widget;
      Boolean owner_events;
      int pointer_mode, keyboard_mode;
      Time time;

Arguments

widgetSpecifies the widget for whose window the keyboard is to be grabbed. 

owner_events
Specifies a Boolean value of either True or False.  See Description below. 

pointer_mode
Controls processing of pointer events during the grab. Pass either Grab­ModeSync or GrabModeAsync. 

keyboard_mode
Controls processing of keyboard events during the grab. Pass either Grab­ModeSync or GrabModeAsync. 

timeSpecifies the time when the grab should take place.  Pass either a timestamp, expressed in milliseconds, or the constant CurrentTime. 

Description

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, XGrabKeyboard immediately returns GrabNotViewable.  No future automatic ungrab is implied by XtGrabKeyboard. 

See Also

XtAddGrab(1), XtGrabButton(1), XtGrabKey(1), XtGrabPointer(1), XtRegisterGrabAction(1), XtUngrabButton(1), XtUngrabKey(1), XtUngrabKeyboard(1), XtUngrabPointer(1).