List.show Function

Format

i = list_name.show(ʃheadingʅ);

Description

The List.show function displays the values from a List and returns the index of the operator's selection. An optional string expression, heading, specifies the title of the window that displays the values. The function is similar to the accept function but with the options taken from the List's values.

Return Value

The function returns the index of the item selected: 1 for the first value, 2 for the second value, etc. The value 0 is returned if the escape key (or back button) is pressed and none of the values is chosen.

Example

List string drink_options = "Water", "Milk", "Soda", "Coffee", "Tea";

numeric favorite_drink_index = drink_options.show("What is your favorite drink?");

if favorite_drink_index <> 0 then
errmsg("You like %s the most!", drink_options(favorite_drink_index));
endif;