Specifications

Athena Widget Set libXaw 1.0.7

yThe location of the upper left outside corner of this widget in its parent.

3.10.2. Toggle Actions

The Toggle widget supports the following actions:

•Switching the Toggle widget between the foreground and background colors with set and

unset and toggle

•Processing application callbacks with notify

•Switching the internal border between highlighted and unhighlighted states with highlight

and unhighlight

The following are the default translation bindings used by the Toggle widget:

<EnterWindow>: highlight(Always)

<LeaveWindow>: unhighlight( )

<Btn1Down>,<Btn1Up>: toggle( )notify( )

3.10.3. Toggle Actions

The full list of actions supported by Toggle is:

highlight(condition)Displays the internal highlight border in the color (foreground or back-

ground )that contrasts with the interior color of the Toggle widget. The

conditions WhenUnset and Always are understood by this action proce-

dure. If no argument is passed then WhenUnset is assumed.

unhighlight() Displays the internal highlight border in the color (foreground or back-

ground )that matches the interior color of the Toggle widget.

set() Enters the set state, in which notify is possible. This action causes the

Toggle widget to display its interior in the foreground color.The label

or bitmap is displayed in the background color.

unset() Cancels the set state and displays the interior of the Toggle widget in the

background color.The label or bitmap is displayed in the foreground

color.

toggle() Changes the current state of the Toggle widget, causing to be set if it was

previously unset, and unset if it was previously set. If the widget is to be

set, and is in a radio group then this procedure may unset another Toggle

widget causing all routines on its callback list to be invoked. The call-

back routines for the Toggle that is to be unset will be called before the

one that is to be set.

reset() Cancels any set or highlight and displays the interior of the Toggle wid-

get in the background color,with the label displayed in the foreground

color.

notify() When the Toggle widget is in the set state this action calls all functions

in the callback list named by the callback resource. The value of the

call_data argument in these callback functions is undeﬁned.

Note

When a bitmap of depth greater that one (1) is speciﬁed the set(), unset(), and reset()

actions have noeffect, since there are no foreground and background colors used in a

multi-plane pixmap.