|
|
Multi-Choice Interaction Variables
MULTI_CHOICE interaction variables allow the GPP developer to define a variable that can get one value out of a list of allowed values.
MULTI_CHOICE variables are actually numeric integer variables. They use the value 1 to represent the first choice, 2 for the second choice, and so on. They should never be assigned values smaller than 1 or larger than the number of options defined for them.
The actual internal format of MULTI_CHOICE variables is SEQUENCING (if used for OUTPUT, the result will be a number, with the SEQUENCING format).
In MULTI_CHOICE interaction variables, the prompt string must contain the actual prompt to be used, followed by all the choices displayed to the user, separated by the "/" character. The total length of the prompt string is limited to 256 characters.
Example
INTERACTION (MULTI_CHOICE) "Tool Change/Auto/Manual" TC = 1;
The initial value is 1, which corresponds to the first choice of Auto. A value of 2 represents Manual, and no other values are valid.
INTERACTION (MULTI_CHOICE)
"Support arcs on planes:/None/XY Only/Major Planes/Any Plane"
ARCS_CTRL_BYPLANE; // system variable examples
In this example, the user gets to see and potentially change the way the machine handles arcs. It is a four-choice system variable, initialized by the corresponding DF2 parameter. The format of ARCS_CTRL_BYPLANE is not modified.
GPP2 does not enforce the assignment of specific valid numbers to MULTI_CHOICE variables. It is the responsibility of the GPP developer to ensure that the assigned values fall within the valid range.
|
