xmgetfocuswidget(3x) [osf1 man page]

XmGetFocusWidget(3X)													      XmGetFocusWidget(3X)

NAME

       XmGetFocusWidget - Returns the ID of the widget that has keyboard focus

SYNOPSIS

       #include <Xm/Xm.h>

       Widget XmGetFocusWidget (widget)
	       Widget widget;

DESCRIPTION

       XmGetFocusWidget  examines  the hierarchy that contains the specified widget and returns the ID of the widget that has keyboard focus.  The
       function extracts the widget ID from the associated Shell widget; therefore the specified widget can be located anywhere in the	hierarchy.
       Specifies a widget ID within a given hierarchy

RETURN VALUE

       Returns the ID of the widget with keyboard focus.  If no child of the Shell has focus, the function returns NULL.

SEE ALSO

       XmProcessTraversal(3X)

															      XmGetFocusWidget(3X)

XmIsTraversable(3X)													       XmIsTraversable(3X)

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  sensi-
       tive,  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 XmNtraverseOb-
       scuredCallback 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.  Specifies the ID of the wid-
       get

RETURN VALUE

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

SEE ALSO

       XmGetVisibility(3X), XmProcessTraversal(3X)

															       XmIsTraversable(3X)