ultrix man page for xtsetkeyboardfocus

XtSetKeyboardFocus(3Xt) 					     MIT X11R4						   XtSetKeyboardFocus(3Xt)

Name
       XtSetKeyboardFocus - focus events on a child widget

Syntax
       XtSetKeyboardFocus(subtree descendant)
	  Widget subtree, descendant;

Arguments
       descendant
		 Specifies either the widget in the subtree structure which is to receive the keyboard event, or Note that it is not an error to
		 specify when no input focus was previously set.

       w	 Specifies the widget for which the keyboard focus is to be set.

Description
       If a future or event occurs within the specified subtree, causes to remap and send the event to the specified descendant widget.

       When there is no modal cascade, keyboard events can occur within a widget W in one of three ways:

       o    W has the X input focus.

       o    W has the keyboard focus of one of its ancestors, and the event occurs within the ancestor or one of the ancestor's descendants.

       o    No ancestor of W has a descendant within the keyboard focus, and the pointer is within W.

       When there is a modal cascade, a widget W receives keyboard events if an ancestor of W is in the active subset of the modal cascade and one
       or more of the previous conditions is

       When subtree or one of its descendants acquires the X input focus or the pointer moves into the subtree such that keyboard events would now
       be delivered to subtree, a event is generated for the descendant if events have been selected by the descendant.  Similarly, when W loses
       the X input focus or the keyboard focus for one of its ancestors, a event is generated for descendant if events have been selected by the
       descendant.

See Also
       XtCallAcceptFocus(3Xt)
       X Window System Toolkit: The Complete Programmer's Guide and Specification, Paul J. Asente and Ralph Swick
       X Window System: The Complete Reference, Second Edition, Robert W. Scheifler and James Gettys

															   XtSetKeyboardFocus(3Xt)