NAME

       XmIsTraversable   —  A  function  that  identifies  whether  a  widget  can  be  traversed
       "XmIsTraversable"

SYNOPSIS

       #include <Xm/Xm.h>
       Boolean XmIsTraversable(
       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.
             If an application unmaps a widget that has its XmNmappedWhenManaged resource set  to
             True, the return value is undefined.

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

       Note that when all widgets in a shell hierarchy have been  made  untraversable,  they  are
       considered  to have lost focus. When a widget in this hierarchy is made traversable again,
       it regains focus.

       XmIsTraversable may return unexpected results when widget or its ancestors are  overlapped
       by their siblings.

       widget    Specifies the ID of the widget

RETURN

       Returns  True  if  the  widget  is  eligible  to receive focus through keyboard traversal;
       otherwise, returns False.

RELATED

       XmGetVisibility(3) and XmProcessTraversal(3).

                                                                               XmIsTraversable(3)