Volume 6A: Motif Programming Manual

0x78, 0x00, 0xf0, 0x00, 0xe0, 0x01, 0xc0, 0x03, 0xff, 0xff, 0xff, 0xff,

0xff, 0xff, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00};

The XmNselectInsensitivePixmap resource can be used to specify a third pixmap to be used when the widget

or gadget is insensitive, but in a selected state. When a ToggleButton is insensitive, the user cannot change its value

interactively.

12.3.4 ToggleButton Callbacks

The primary callback routine associated with the ToggleButton is the XmNvalueChangedCallback, which is

invoked when the value of the ToggleButton changes. The ToggleButton also has arm and disarm callbacks that are

analogous to the callbacks in PushButtons. The callback structure associated with the ToggleButton callback routines

is XmToggleButtonCallbackStruct, which is defined as follows:

typedef struct {

int reason;

XEvent *event;

int set;

} XmToggleButtonCallbackStruct;

When the value of the ToggleButton has changed, the reason field is set to XmCR_VALUE_CHANGED and the set

field indicates the current state of the widget.

You can determine the state of a ToggleButton at any time using either XmToggleButtonGetState() or

XmToggleButtonGadgetGetState(). These functions take the following form:

Boolean

XmToggleButtonGetState(toggle_w)

Widget toggle_w;

Boolean

XmToggleButtonGadgetGetState(toggle_w)

Widget toggle_w;

Both of the routines return the state of the specified ToggleButton. XmToggleButtonGetState() determines if

the toggle_w parameter is a widget or a gadget, so you can use the routine on either ...