Definition
Define a group box.
[enabled|disabled] [visible|invisible] [[color] COLOR]
group box GB_NAME
size WIDTH HEIGHT at [position] X Y in DB_NAME
[parameter is PAR_STRING]
[helpid is HELP_ID]
[text TEXT_STRING]
[font FONT_NAME]
enabled | disabled
Define the group box as selectable or not. If you define it 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.
GB_NAME
The identifier for a group box.
size WIDTH HEIGHT
Integer values representing the dimensions of the group box in dialog units.
at position X Y
Integer values representing the position of the group box 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 group box. The default PAR_STRING is "".
helpid is HELP_ID
Because a group box cannot have the focus, you cannot use the helpid for a group box to display a help panel. However, you can use HELP_ID as a second parameter for use within your program.
text TEXT_STRING
A string value representing the text you want displayed in the upper left-hand corner of the group box. 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 group box is a dialog control and must have a dialog box or dialog region as its parent.
Only the group box keywords, the identifier, the at [position] specification, the size specification, and in DB_NAME are required in the definition.
When specifying attributes, you can specify parameter, helpid, text, and font in any order; specify all other attributes in the order shown in the model.
Example
...
group box Destination_GB
size 100 40 at position 6 20 in SaveFile
text "Destination"
checked radio button HardDisk_RB
size 48 11 at position 10 30 in SaveFile
group is Options
text "to Hard Disk"
radio button Network_RB
size 48 11 at position 60 30 in SaveFile
group is Options
text "to Network"
See Also
font is Font Reference Definition
