1XmIsTraversable(library call) XmIsTraversable(library call)
2
3
4
6 XmIsTraversable — A function that identifies whether a widget can be
7 traversed
8
10 #include <Xm/Xm.h>
11 Boolean XmIsTraversable(
12 Widget widget);
13
15 XmIsTraversable determines whether the specified widget is eligible to
16 receive focus through keyboard traversal. In general, a widget is eli‐
17 gible to receive focus when all of the following conditions are true:
18
19 · The widget and its ancestors are not being destroyed, are sensi‐
20 tive, and have a value of True for XmNtraversalOn.
21
22 · The widget and its ancestors are realized, managed, and (except
23 for gadgets) mapped. If an application unmaps a widget that has
24 its XmNmappedWhenManaged resource set to True, the return value
25 is undefined.
26
27 · Some part of the widget's rectangular area is unobscured by the
28 widget's ancestors, or some part of the widget's rectangular area
29 is inside the work window (but possibly outside the clip window)
30 of a ScrolledWindow whose XmNscrollingPolicy is XmAUTOMATIC and
31 whose XmNtraverseObscuredCallback is not NULL.
32
33 Some widgets may not be eligible to receive focus even if they meet all
34 these conditions. For example, most managers cannot receive focus
35 through keyboard traversal. Some widgets may be eligible to receive
36 focus under particular conditions. For example, a DrawingArea is eli‐
37 gible to receive focus if it meets the conditions above and has no
38 child whose XmNtraversalOn resource is True.
39
40 Note that when all widgets in a shell hierarchy have been made
41 untraversable, they are considered to have lost focus. When a widget in
42 this hierarchy is made traversable again, it regains focus.
43
44 XmIsTraversable may return unexpected results when widget or its ances‐
45 tors are overlapped by their siblings.
46
47 widget Specifies the ID of the widget
48
50 Returns True if the widget is eligible to receive focus through key‐
51 board traversal; otherwise, returns False.
52
54 XmGetVisibility(3) and XmProcessTraversal(3).
55
56
57
58 XmIsTraversable(library call)