Widget_Activation/Association(3W)UNIX System VWidget_Activation/Association(3W)
NAME
OlActivateWidget, OlAssociateWidget, OlUnassociateWidget - three routines
for activating widget based on widget type
SYNOPSIS
#include <OpenLook.h>
Boolean OlActivateWidget(widget, activation_type, data)
Widget widget;
OlVirtualName activation_type;
XtPointer data;
Boolean OlAssociateWidget(leader, follower, disable_traversal)
Widget leader;
Widget follower;
Boolean disable_traversal;
void OlUnassociateWidget(follower)
Widget follower;
DESCRIPTION
OlActivateWidget programmatically activates a widget using the specified
type. (See the widget manual pages for valid activation types.) The
function returns TRUE if the activation type was accepted by the supplied
widget or one of its associated followers; otherwise, FALSE is returned.
When activating a widget, if the initially-supplied widget does not
accept the activation request, OlActivateWidget recursively attempts to
activate all associated follower widgets until one of them accepts the
activation type.
OlAssociateWidget associates a widget (the follower) with another widget
(the leader). Associating a widget with a lead widget effectively
expands the number of ways the lead widget can be activated since
OlActivateWidget automatically activates any follower widgets if the lead
widget does not accept the supplied activation type. This routine
returns TRUE if the association was successful; otherwise FALSE is
returned. Attempts to create an association-cycle is illegal and
produces a warning. It's typically desirable to prevent keyboard
traversal into widgets which are associated with other widgets. The
disable_traversal parameter is a convenient interface to setting the
follower widget's XtNtraversalOn resource to FALSE.
OlUnassociateWidget removes a follower widget from a previous association
with another lead widget. No warning is generated if the supplied widget
was not previously associated with another widget.
10/89 Page 1
Widget_Activation/Association(3W)UNIX System VWidget_Activation/Association(3W)
NOTE
The above routines accept gadgets arguments also.
Page 2 10/89