Radio Lists

 

A radio list is a group of mutually exclusive buttons. Only one may be selected at a time. The format of a radio list definition is:

 

Radio List {"item name"} hpos, vpos {, width {, height}} {options}

Radio Button {"item name"} hpos, vpos {, width {, height}} {options} {do

     <statements go here>

     endItem}

<more radio button items go here>

 

The radio button items must immediately follow the radio list item in the dialog box resource. The radio list item appears as a rectangular frame of the specified size with an optional title (see the Prompt option below). The radio button items are typically placed within this frame to identify them as part of the same group, but can be placed anywhere. In addition, other dialog box items can be positioned inside the frame.

 

The radio list item cannot have a do ... endItem section, but the individual radio button items can. The statements in a radio button item's do ... endItem section, if specified, are executed when the user clicks on that specific radio button. Radio button items can be enabled, disabled, hidden, and shown individually. Enabling, disabling, hiding, or showing the radio list item, however, affects all of the radio buttons.

 

Radio List Options	Description
Disabled	The radio list and all radio buttons are initially disabled.
Hidden	The radio list and all radio buttons are initially hidden.
Prompt: expression	The text that appears in the frame of the radio list item. If omitted, there is no text in the frame.
Variable: variable	An integer indicating which button is selected. The first radio button is number one.

 

Radio Button Options	Description
Key: hotkey	The key sequence the user can press to select the radio button instead of using the mouse. The hotkey has the format alt_ character, where character must be a letter or number. For example, Key: alt_A indicates that holding the Alt key and pressing A activates the item. The specified key is underlined in the item's text. A hotkey only works if the key in question is part of the item's text and is case insensitive.
Disabled	The radio button is initially disabled.
Hidden	The radio button is initially hidden.
Prompt: expression	The text of the radio button. If omitted, the name of the item is used.
Help: help_specs	Help information displayed in a popup window and the status bar. Help strings can be string expressions.

 

For example:

 

Radio List 1, 5, 30, 3 Prompt: "Selection is" Variable: selection

Radio Button 2, 6 Prompt: "Enclosed"

Radio Button 2, 7 Prompt: "Intersecting"