.\\$1D \\$2 \\$1
.if \\n(VS>=40 .vs \\n(VSu
.if \\n(VS<=39 .vs \\n(VSp
..
 0
.nr BD 0

.KS .TA .5i 3i

..

.. .. .KS

.D

 choose appropriate monospace font
 the imagen conditional, 480,
 may be changed to L if LB is too
 heavy for your eyes...

..

.R
..
..
..
.TB

\\*(NO
.R
..
. \" Note End -- doug kraft 3/85
 0
..
.ny0
 XtSetKeyboardFocus 3Xt "Release 3" "X Version 11" "XT FUNCTIONS"
 NAME
XtSetKeyboardFocus - focus events on a child widget
 SYNTAX
XtSetKeyboardFocus(subtree\, descendant)

 Widget subtree, descendant;
 ARGUMENTS
 descendant 1i
Specifies either the widget in the subtree structure which is to receive the 
keyboard event, or 
.ZN None .
Note that it is not an error to specify
.ZN None
when no input focus was previously set.
 w 1i
Specifies the widget \*(Wi.
 DESCRIPTION
If a future 
.ZN KeyPress
or
.ZN KeyRelease 
event occurs within the specified subtree,
.ZN XtSetKeyboardFocus
causes
.ZN XtDispatchEvent
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:
 \(bu 5
W has the X input focus.
 \(bu 5
W has the keyboard focus of one of its ancestors,
and the event occurs within the ancestor or one of the ancestor's descendants.
 \(bu 5
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
.ZN True .

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
.ZN FocusIn
event is generated for the descendant if
.ZN FocusNotify
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
.ZN FocusOut
event is generated for descendant if
.ZN FocusNotify
events have been selected by the descendant.
 "SEE ALSO"
XtCallAcceptFocus(3Xt)

\*(xT

\*(xL