NAME¶
XtSetKeyboardFocus - focus events on a child widget
SYNTAX¶
XtSetKeyboardFocus(Widget subtree, Widget
descendant);
ARGUMENTS¶
- subtree
- 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.
- descendant
- 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
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:
- •
- W has the X input focus.
- •
- W has the keyboard focus of one of its ancestors, and the event occurs
within the ancestor or one of the ancestor's descendants.
- •
- 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
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
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
FocusOut event is generated for descendant if
FocusNotify
events have been selected by the descendant.
SEE ALSO¶
XtCallAcceptFocus(3)
X Toolkit Intrinsics - C Language Interface
Xlib - C Language X Interface