ValueSet.show Function

Format

d = valueset_name.show(ʃheadingʅ);

Description

The ValueSet.show function displays the labels from a ValueSet object and returns the code (or 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 value set's labels. For numeric value sets, the returned value corresponds with the selected label's code. For a string value set, the returned value is the index of the selected label.

Return Value

The function returns the code (or index) of the item selected. If the selected value contains a special value, then that value is returned. The value 0 is returned if the escape key (or back button) is pressed and none of the values is chosen.

Example

ValueSet respondent_query;

do numeric counter = 1 while counter <= count(NAME)
respondent_query.add(NAME(counter), LINE_NUMBER(counter));
enddo;

numeric respondent_line_number = respondent_query.show("Who in the household is responding to questions?");