1XtSetKeyboardFocus(3)            XT FUNCTIONS            XtSetKeyboardFocus(3)
2
3
4

NAME

6       XtSetKeyboardFocus - focus events on a child widget
7

SYNTAX

9       XtSetKeyboardFocus(Widget subtree, Widget descendant);
10

ARGUMENTS

12       subtree   Specifies either the widget in the subtree structure which is
13                 to receive the keyboard event, or None.  Note that it is not
14                 an error to specify None when no input focus was previously
15                 set.
16
17       descendant
18                 Specifies the widget for which the keyboard focus is to be
19                 set.
20

DESCRIPTION

22       If a future KeyPress or KeyRelease event occurs within the specified
23       subtree, XtSetKeyboardFocus causes XtDispatchEvent to remap and send
24       the event to the specified descendant widget.
25
26       When there is no modal cascade, keyboard events can occur within a wid‐
27       get W in one of three ways:
28
29       ·    W has the X input focus.
30
31       ·    W has the keyboard focus of one of its ancestors, and the event
32            occurs within the ancestor or one of the ancestor's descendants.
33
34       ·    No ancestor of W has a descendant within the keyboard focus, and
35            the pointer is within W.
36
37       When there is a modal cascade, a widget W receives keyboard events if
38       an ancestor of W is in the active subset of the modal cascade and one
39       or more of the previous conditions is True.
40
41       When subtree or one of its descendants acquires the X input focus or
42       the pointer moves into the subtree such that keyboard events would now
43       be delivered to subtree, a FocusIn event is generated for the descen‐
44       dant if FocusNotify events have been selected by the descendant.  Simi‐
45       larly, when W loses the X input focus or the keyboard focus for one of
46       its ancestors, a FocusOut event is generated for descendant if FocusNo‐
47       tify events have been selected by the descendant.
48

SEE ALSO

50       XtCallAcceptFocus(3)
51       X Toolkit Intrinsics - C Language Interface
52       Xlib - C Language X Interface
53
54
55
56X Version 11                      libXt 1.1.5            XtSetKeyboardFocus(3)
Impressum