XmIsTraversable

NAME

XmIsTraversable - A function that identifies whether a widget can be traversed

SYNOPSIS

#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.

RELATED INFORMATION

XmGetVisibility(3X) and XmProcessTraversal(3X).