Museum

Home

Lab Overview

Retrotechnology Articles

Online Manuals

⇒ XmIsTrave(Xm) — OpenDesktop Software Development System 3.0.0

Media Vault

Software Library

Restoration Projects

Artifacts Sought


 XmIsTraversable(Xm)            6 January 1993            XmIsTraversable(Xm)


 Name

    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 eligi-
    ble 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 eligi-
    ble 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).


Typewritten Software • bear@typewritten.org • Edmonds, WA 98026