<HTML>
<HEAD>
<TITLE></TITLE>
</HEAD>
<BODY>
<PRE>



XtGrabKey(3Xt)		   XT FUNCTIONS		   XtGrabKey(3Xt)


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

SYNTAX
       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, cur_
       sor)
	     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, keyboard_mode, confine_to, cursor, time)
	     Widget widget;
	     Boolean owner_events;



X Version 11		   Release 6.1				1





XtGrabKey(3Xt)		   XT FUNCTIONS		   XtGrabKey(3Xt)


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

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 XtDis_
       patchEvent 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 condi
       tions 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.

       XtUngrabKey calls XUngrabKey specifying the widget's win
       dow 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, key
       code, and modifiers.



X Version 11		   Release 6.1				2





XtGrabKey(3Xt)		   XT FUNCTIONS		   XtGrabKey(3Xt)


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

	 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.

       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 wid
       get 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 Interface








X Version 11		   Release 6.1				3


</PRE>
</BODY>
</HTML>
