MSM-Workstation
Macros

Go back to the alphabetic list of macros
Go back to the first page of this tutorial

%%ResetChoice ( Object , Variable [ , SubscriptType [ , DataType ] ] )

Reset the choices of a control.

Object The control whose selections are to be reset. If missing, default to the current control. The control should be a type that can take a list of choices (a list type, radio button, or table).

Variable The name of the variable containing the choices.

SubscriptType A single letter (default is I) identifying the contents of the subscripts in Variable, one of: A (application identifiers), I (internal identifiers), T (titles), R (rows), C (columns). Multiple letters indicate multiple subscripts. Rows and columns apply to table controls only.

DataType A single letter (default is T) identifying the data stored in Variable at a subscripted node, one of: A (application identifiers), I (internal identifiers), T (titles).

The macro %%ResetChoice is used to reset the choices in a control that can present a list of alternatives. It uses an array of choices with the default structure Variable(Id)=Title. Choices can also be identified by application identifications (AppIDs).

Previously set choices are cleared by the macro %%ResetChoice. To add possible choices to a list of existing possibilities, use the macro %%SetChoice.

Examples

%%ResetChoice(Drinks,DR)
Use local array DR(Id)=Title to build the choices in the control called "Drinks".

%%ResetChoice(Drinks,DR,T,A)
Use local array DR(Title)=AppID to build the choices in the control called "Drinks". Note that this will build an alphabetical list.

See also

%%Get, %%GetChoice, %%GetSel, %%Prop, %%Reset, %%ResetSel/a>, %%Set, %%SetChoice and %%SetSel.