Text Properties - Appearance Display Value (Array)
- Last UpdatedMar 11, 2025
- 2 minute read
Text has the following Array Display Value properties:
Array expression
Enter the expression which is to return one or more integers. For each returned integer, a different piece of text is displayed.
If the return value is:
-
Less than 0 (zero), it will be set to 0 (zero), and a runtime hardware alarm will be triggered.
-
Greater than 255, it will be set to 255, and a runtime hardware alarm will be triggered.
-
A real (non-integer) number, it will be rounded off to the nearest integer.
To insert a tag or a function, click the Wizard button to the right of this field. This button displays two options: Insert Tag and Insert Function.
Note: You can also insert Equipment.item references into expression fields using the insert tag option; however if no equipment has been configured in your system the list will be empty. You will need to configure equipment to populate the list with available tags.
Array text
The text that is to display for each integer returned by the Array expression entered above. You can enter any keyboard character(s).
For example, to display different messages about the status of a motor, you could fill out the Array expression and Array text fields as follows:
|
Array expression |
Array text |
|
|---|---|---|
|
MOTOR_STATUS |
0 1 2 3 4 5 |
Running Starting Stopping Stopped - Normal Stopped - Error Isolated |
In this example, MOTOR_STATUS is an analog variable tag representing the status of a motor. When the motor changes state, an integer is returned (0 = Running, 1 = Starting etc.) and the appropriate text displays.
If you want to remove the existing details for the property, click Clear Property.
See Also
Text Properties - Appearance Display Value (On/Off)
Text Properties - Appearance Display Value (Multi-state)