XtSetKeyboardFocus(3Xt) XT FUNCTIONS XtSetKeyboardFocus(3Xt)
XtSetKeyboardFocus - focus events on a child widget
XtSetKeyboardFocus(Widget subtree, Widget descendant);
subtree 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.
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 wid-
get.
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 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.
XtCallAcceptFocus(3Xt)
X Toolkit Intrinsics - C Language Interface
Xlib - C Language X Interface
XFree86 Version 4.5.0 1
Generated on 2012-02-20 02:47:02 by $MirOS: src/scripts/roff2htm,v 1.70 2011/12/03 18:21:12 tg Exp $
These manual pages and other documentation are copyrighted by their respective writers;
their source is available at our CVSweb,
AnonCVS, and other mirrors. The rest is Copyright © 2002‒2011 The MirOS Project, Germany.
This product includes material
provided by Thorsten Glaser.
This manual page’s HTML representation is supposed to be valid XHTML/1.1; if not, please send a bug report – diffs preferred.