DOC HOME SITE MAP MAN PAGES GNU INFO SEARCH
 

XmProcessTraversal(Xm)


XmProcessTraversal -- a function that determines which component receives keyboard events when a widget has the focus

Syntax

#include <Xm/Xm.h>

Boolean XmProcessTraversal (widget, direction) Widget widget; XmTraversalDirection direction;

Description

XmProcessTraversal determines which component of a hierarchy receives keyboard events when the hierarchy that contains the given widget has keyboard focus. Using XmProcessTraversal to traverse to MenuBars, Pulldown MenuPanes, or Popup MenuPanes is not supported.

widget
Specifies the widget ID of the widget whose hierarchy is to be traversed. The hierarchy is only traversed up to the top of the shell. If that shell does not currently have the focus, any changes to the element with focus within that shell will not occur until the next time the shell receives focus.

direction
Specifies the direction of traversal.

The direction parameter can have the following values, which cause the routine to take the corresponding actions:

Cautions

Return value

Returns True if the setting succeeded. Returns False if the keyboard focus policy is not XmEXPLICIT, if there are no traversable items, or if the call to the routine has invalid parameters.

See also

XmGetVisibility(Xm) and XmIsTraversable(Xm).
© 2003 Caldera International, Inc. All rights reserved.
SCO OpenServer Release 5.0.7 -- 11 February 2003