function, similar to the show
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
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_title
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.