XmIsTraversable(Xm)
XmIsTraversable --
a function that identifies whether a widget can be traversed
Syntax
#include <Xm/Xm.h>
Boolean XmIsTraversable (widget)
Widget widget;
Description
XmIsTraversable determines whether the specified widget is
eligible to receive focus through keyboard traversal.
In general, a widget is eligible to receive focus when all of the
following conditions are true:
-
The widget and its ancestors are not being destroyed, are sensitive, and
have a value of True for XmNtraversalOn.
-
The widget and its ancestors are realized, managed, and (except for
gadgets) mapped.
-
Some part of the widget's rectangular area is unobscured by the widget's
ancestors, or some part of the widget's rectangular area is inside the
work window (but possibly outside the clip window) of a ScrolledWindow
whose XmNscrollingPolicy is XmAUTOMATIC and whose
XmNtraverseObscuredCallback is not NULL.
Some widgets may not be eligible to receive focus even if they meet all
these conditions.
For example, most managers cannot receive focus through keyboard traversal.
Some widgets may be eligible to receive focus under particular
conditions.
For example, a DrawingArea is eligible to receive focus if it meets the
conditions above and has no child whose XmNtraversalOn resource is
True.
widget-
Specifies the ID of the widget
Return value
Returns True if the widget is eligible to receive focus through keyboard
traversal; otherwise, returns False.
See also
XmGetVisibility(Xm)
and
XmProcessTraversal(Xm).
© 2003 Caldera International, Inc. All rights reserved.
SCO OpenServer Release 5.0.7 -- 11 February 2003