Definition
Define a radio button.
[enabled|disabled] [visible|invisible]
[[color] COLOR] [checked]
radio button RB_NAME
size WIDTH HEIGHT at [position] X Y in DB_NAME
[parameter is PAR_STRING]
[helpid is HELP_ID]
[group is GROUP_NAME]
[text TEXT_STRING]
[font FONT_NAME]
enabled | disabled
Define the radio button as selectable or not. If you define the radio button as disabled, it is displayed grayed and cannot be selected. The default is enabled.
visible | invisible
A visible object is displayed when it is defined. An invisible object is not displayed until you specifically make it visible. The default is visible.
color COLOR
A color keyword, a string value representing a color keyword, or an integer value representing a color number corresponding to a color available on your system.
checked
Display this radio button filled in. The default is unchecked.
RB_NAME
The identifier for a radio button.
size WIDTH HEIGHT
Integer values representing the dimensions of the radio button in dialog units.
at X Y
Integer values representing the position of the radio button in dialog units.
in DB_NAME
The identifier for the dialog box or dialog region parent object.
parameter is PAR_STRING
A string value representing the parameter of the radio button. The default value is "".
helpid is HELP_ID
A string or integer value representing the help panel identifier. This should match the help panel defined in the library specified by the help library declaration. The default HELP_ID is " ".
group is GROUP_NAME
Group this radio button with all other dialog control objects that specify this group name. When one radio button in a group is checked, all others in the group are automatically unchecked.
text TEXT_STRING
A string value representing the text of the radio button. This text will be displayed to the right of the radio button. If a character in the string is preceded by the ~ character, that character is used as the mnemonic for the radio button and will be underlined in the text of the button. If the user presses this letter, when not in an entry field, this object will be selected. The default TEXT_STRING is " ".
font FONT_NAME
The name of the font in which you want the TEXT_STRING to appear. You may use either system or ESL fonts. (See the description of the font is Font Reference Definition.)
You cannot change the font of a control at runtime.
Description
A radio button is a dialog control and must have a dialog box or dialog region as its parent.
Only the radio button keywords, the identifier, the at specification, the size specification, and in DB_NAME are required in the definition.
When specifying attributes, parameter, group is, font, and text can be specified in any order; all other attributes must be specified in the order shown in the model.
Example
invisible dialog box SaveFile
size 160 100 at position 200 200
dialog border
title bar "Save Output File"
system menu
checked radio button HardDisk
size 48 11 at position 6 20 in SaveFile
group is Options
text "to Hard Disk"
radio button Network
size 48 11 at position 70 20 in SaveFile
group is Options
text "to Network"
See Also
is checked Object/Item Inquiry Built-in Function
