-- Command: cycle ID/K, COMMAND/K, PORT/K, HELP/K, NODE/K, ATTRS/K/M,
LABEL=LABELS/K/F
Cycle gadget objects are created with this command. Cycle and
radio gadgets are essentially identical with the only difference
being the base object class to create each type of object. All
options are identical for these objects.
* ID [I..] - an id can be assigned to a gadget for later
reference. The id can be any combination of up to 5
characters. If the id is given without any other arguments,
and the gadget has been previously created, then the
currently selected label will be returned in RESULT (if
OPTIONS RESULTS is specified in the script).
* COMMAND [I..] - if given, the command will be executed
whenever the gadget is selected. For a complete description
of this option see Command-Port Options. Note that the
gadget active label (see the LABELS argument description)
will be used to replace a `%s' contained in the command
string.
* PORT [I..] - a specific host port may be specified by this
argument. For a complete description of this option see
Command-Port Options.
* HELP [I..] - with this argument help text may be defined
which will be displayed as balloon help whenever the pointer
is over the associated gadget. Of course, this is dependant
on whether the user set up balloon help in the MUI preference
settings.
* NODE [I..] - this argument is used to specify a node in the
guide file given in the command line argument HELP for
`MUIRexx'. If the user positions the mouse pointer over the
gadget and presses the help button on the keyboard then the
guide file will be displayed at the node location.
* LABELS [ISG] - a series of strings (separated by commas) may
be specified by this argument. These strings are used as the
labels for the gadget object. The currently displayed label
may be retrieved by issuing the gadget command with an
existing ID. Also, the selected label may be set by issuing
the gadget command with an existing ID and label. Note that
the labels may contain any of the special formatting
sequences (see MUI Format Sequences).
* ATTRS [ISG] - with this option any MUIA attribute TAGs may be
set or retrieved (see Attribute TAGs).
Some useful TAGs for use with this command are:
TAG_Name = TAG_id Flags Type
Cycle_Active = 0x80421788 /* V4 isg LONG */
Radio_Active = 0x80429b41 /* V4 isg LONG */
ControlChar = 0x8042120b /* V4 isg char */
CycleChain = 0x80421ce7 /* V11 isg LONG */
Disabled = 0x80423661 /* V4 isg BOOL */
FixHeight = 0x8042a92b /* V4 i.. LONG */
FixHeightTxt = 0x804276f2 /* V4 i.. STRPTR */
FixWidth = 0x8042a3f1 /* V4 i.. LONG */
FixWidthTxt = 0x8042d044 /* V4 i.. STRPTR */
HorizDisappear = 0x80429615 /* V11 isg LONG */
HorizWeight = 0x80426db9 /* V4 isg WORD */
MaxHeight = 0x804293e4 /* V11 i.. LONG */
MaxWidth = 0x8042f112 /* V11 i.. LONG */
Selected = 0x8042654b /* V4 isg BOOL */
ShowMe = 0x80429ba8 /* V4 isg BOOL */
VertDisappear = 0x8042d12f /* V11 isg LONG */
VertWeight = 0x804298d0 /* V4 isg WORD */
Weight = 0x80421d1f /* V4 i.. WORD */
Note: Consult MUI:Developer/Autodocs/MUI_Cycle.doc, MUI_Radio.doc,
MUI_Area.doc and MUI:Developer/C/Include/libraries/mui.h
Example use of this command:
window ID PAGE TITLE '"Character Definition"'
group HORIZ
group
label SINGLE 'Name:'
label SINGLE 'Sex:'
endgroup
group
string ID NAME CONTENT 'Frodo'
cycle ID SEX LABELS 'male,female'
endgroup
endgroup
space 2
group REGISTER LABELS 'Race,Class,Armor,Level'
group FRAME
radio ID RACE LABELS 'Human,Elf,Dwarf,Hobbit,Gnome'
endgroup
.
.
.
endwindow
cycle ID SEX
say result
radio ID RACE
say result