XtSetKeyboardFocus(3Xt) XT FUNCTIONS XtSetKeyboardFocus(3Xt)NAMEXtSetKeyboardFocus - 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 None. Note that it is not an error to
specify None when no input focus was previously
set.
w Specifies the widget for which the keyboard
focus is to be set.
DESCRIPTION
If a future KeyPress or KeyRelease event occurs within the
specified subtree, XtSetKeyboardFocus causes XtDis-
patchEvent 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 key-
board events if an ancestor of W is in the active subset
of the modal cascade and one or more of the previous con-
ditions is 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
FocusIn event is generated for the descendant if FocusNo-
tify events have been selected by the descendant. Simi-
larly, when W loses the X input focus or the keyboard
focus for one of its ancestors, a FocusOut event is gener-
ated for descendant if FocusNotify events have been
selected by the descendant.
SEE ALSOXtCallAcceptFocus(3Xt)
X Toolkit Intrinsics - C Language Interface
X Version 11 Release 6.4 1
XtSetKeyboardFocus(3Xt) XT FUNCTIONS XtSetKeyboardFocus(3Xt)
Xlib - C Language X Interface
X Version 11 Release 6.4 2