XmIsTraversable(3X)

NAME
     XmIsTraversable  -- A function that identifies whether a widget can be tra-
     versed

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  re-
     ceive  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  wid-
          get's  ancestors, or some part of the widget's rectangular area is in-
          side the work window (but possibly  outside  the  clip  window)  of  a
          ScrolledWindow  whose XmNscrollingPolicy is XmAUTOMATIC and whose XmN-
          traverseObscuredCallback 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  XmNtraversa-
     lOn 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).

                                                             XmIsTraversable(3X)