Next: xmraise, Previous: xmquery, Up: Internal Routines [Contents][Index]
xmradiobox(parent, callback, font, color,
label1 [,...] [,
columns
])
[motif package]
Creates a radio box widget with radio buttons and returns
the IDs of the radio box widget and the radio buttons. Each radio
button is displayed as a small diamond button with a label after it.
The diamond button looks either depressed (selected), or not depressed
(not selected). Only one of the radio buttons in the widget can be
selected at any one time, and its diamond button is the only one that
looks depressed.
The radio box widget is placed inside the indicated parent
widget. The radio button labels are indicated by the string argument
label1
and following arguments. If the last argument is a
scalar, then it indicates the number of columns in which the radio
buttons are to be placed. The font
applies to the radio
button labels, and the color
to just the radio buttons.
The callback
is a string that gets executed when one of the
radio buttons is selected. The index of the selected button (with
counting starting at 0) can be found in global variable
$RADIO_button
and the state of the selected button (always 1) in
$RADIO_state
. These global variables are also used by other
widgets.
The function returns an array of integers. The first number is the widget ID of the column/row widget that contains the radio buttons. The remaining numbers are the IDs of the individual radio buttons.