NAME

OlActivateWidget, OlAssociateWidget, OlUnassociateWidget − routines for activating widget based on widget type

SYNOPSIS

#include <Xol/OpenLook.h>
 . . .
Boolean OlActivateWidget(

Widget widget,
OlVirtualName activation_type,
XtPointer data);

#include <Xol/OpenLook.h>
 . . .
Boolean OlAssociateWidget(

Widget leader,
Widget follower,
Boolean disable_traversal)

#include <Xol/OpenLook.h>
 . . .
void OlUnassociateWidget(

Widgetfollower);

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.

NOTE

The above routines accept gadgets arguments also. 

Version 3.0.1  —  Last change: June 92