VariableCollection
If a user wants to add a new variable to be monitored on the VariableViewControl, the control needs the following information for the new variable:
- Path of the symbol to read the value.
- Label text which can be a localized symbol or a function binding.
- Unit group of that variable to allow unit conversion for proper display of values.
This information can be prepared using the Variable Collection attribute.
Variable Collection attribute is also used by the configuration dialog that appears on the control.
To make it easier for the user to select an appropriate variable, all the variables are divided into multiple groups.
The name for each group is configured using the GroupLabel attribute in the object editor dialog in engineering environment by the user.

Every group of variables will have Group Label and Variable List.

Every variable list can have multiple variables, each variable has the below properties:
- Symbol: Binding path to the symbol to display on screen.
- Data Type: For a better display the user can define the data type as
FloatDataType
,IntDataType
orBoolDataType
. - Unit Group: Unit group of the displayed symbol.
- Label: Text to be displayed as tile identifier.
- DigitsAfterDecimal: Number of decimal places of all numeric values displayed on the control.
List of all variables that can be selected by the user to show them on the screen.
Schema: tchmi:framework#/definitions/VariableCollection
Attribute getter: getVariableCollection
Attribute setter: setVariableCollection
Available: since version 12.6.0