1XmIsTraversable(library call)                    XmIsTraversable(library call)
2
3
4

NAME

6       XmIsTraversable  —  A  function that identifies whether a widget can be
7       traversed
8

SYNOPSIS

10       #include <Xm/Xm.h>
11       Boolean XmIsTraversable(
12       Widget widget);
13

DESCRIPTION

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

RETURN

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)
Impressum