XmIsTraversable(3X) UNIX System V XmIsTraversable(3X)
NAME
XmIsTraversable - A function that identifies whether a
widget can be traversed
SYNOPSIS
#include <Xm/Xm.h>
Boolean XmIsTraversable (widget)
Widget widget;
VERSION
This page documents version 1.2 of the Motif library.
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.
Page 1 (printed 4/30/98)
XmIsTraversable(3X) UNIX System V XmIsTraversable(3X)
RELATED INFORMATION
XmGetVisibility(3X) and XmProcessTraversal(3X).
Page 2 (printed 4/30/98)