Displays a dialog with radio buttons.
Syntax: @uiradio(arg, prompt, items)
arg: scalar, program variable
prompt: string
items: string
Return: integer
Displays a dialog with a listbox and prompt string that will be used to label the listbox.
• arg should be an scalar or program variable as it is used to return results. arg is used to provide initial selections, and will contain the dialog specified values on return.
• prompt specifies the text used to label the listbox.
• items is a space delimited list of items in the listbox.
Both prompt and items may be specified using in-line text.
The dialog shows an OK and Cancel button, and will return an integer representing the button clicked: Cancel (-1), OK (0).
Examples
scalar selection = 2
@uiradio(selection, "Please select an item:", "Item1 Item2 Item3")
These commands display a dialog with three radio buttons, labeled “Item1”, “Item2”, and “Item3”. The title “Please select an item:” appears above the radio buttons, and the second item is initially selected. If the user selects the third item and presses OK, the scalar SELECTION will contain the value 3, and the dialog will return the value 0.
Cross-references