Expressions Guide - STR (Functions)

STR

The STR function returns the string equivalent of a value.

Function Name	STR
Description	Returns the string equivalent of a value. Usually, the STR function is used to combine a non-string value with string values.
Arguments	STR(Value) Where: Value is an expression that provides the value that is to be converted into a string.
Returns	STRING The input value added to a string and returned as a string.

Example:

A text box is configured on a Mimic. The text box is animated so that it displays the current value of a point named 'Analog Point 1'.

The text box is to have a ToolTip that shows the last update time of the point when the cursor is positioned over the text box. To achieve this effect, the TooltipText property of the text box is animated with this expression:

'Last update time: '+ STR(".Analog Point 1.CurrentTime").

This allows the ToolTip for the text box to show a string that contains a time from the database (the CurrentTime property represents the time of the latest update to the point's values).