The
showarray function, similar to the
show and
accept functions, displays items from an Array in a grid. An optional string expression,
heading, defines the title of the grid, which contains the items in
array_name. The function is useful as a menu or simply as a way to show values that are relevant to data collection. If the optional numeric expressions
row_count and
column_count are not specified, then the function will parse the Array, determining the size of the menu based on where the first blank alphanumeric element is found. If you want to override the column headings, you can specify them in with string expressions in
text_titles.
The function returns the number of the item selected: 1 for the first item, 2 for the second item, etc. The value 0 is returned if the escape key (or back button) is pressed and none of the options is chosen.