XT FUNCTIONS XtSetKeyboardFocus(3xt)
NAME
XtSetKeyboardFocus - focus events on a child widget
SYNTAXcc [ flag... ] file... -lXt [ library... ]
XtSetKeyboardFocus(Widget subtree, Widget descendant);
ARGUMENTSsubtree Specifies either the widget in the subtree struc-
ture 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 thespecified subtree, XtSetKeyboardFocus causes XtDispatchEvent
to remap and send the event to the specified descendant wid-
get. 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 True. When subtree or one of its descendants acquires the X inputfocus or the pointer moves into the subtree such that key-
board 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(3Xt) X Version 11 Last change: libXt 1.0.8 1XT FUNCTIONS XtSetKeyboardFocus(3xt)
X Toolkit Intrinsics - C Language Interface
Xlib - C Language X Interface
ATTRIBUTES
See attributes(5) for descriptions of the following attri-
butes:__________________________________________________________________
| ATTRIBUTE TYPE | ATTRIBUTE VALUE |
|_____________________________|___________________________________|
| Availability | x11/library/toolkit/libxt ||_____________________________|___________________________________|
| Interface Stability | Committed ||_____________________________|___________________________________|
| MT-Level | See XtToolkitThreadInitialize(3XT)|
|_____________________________|___________________________________|
X Version 11 Last change: libXt 1.0.8 2