text is a string expression. In the first version of the function, each choice (choice1
) is provided as a string expression. In the second version of the function, the choices can be provided using a string list
or a string or alphanumeric array
. With an array, the number of choices will be calculated dynamically. Each element of the array will be displayed until a blank string is found in the array.
The function returns the index of the choice selected: 1 for the first choice, 2 for the second choice, etc. The value 0 is returned if the Escape key (or back button) is pressed and none of the choices is selected.