Technical Reference Manual - InduSoft

Appendix: Built-in Scripting Language
The number of decimal places to be displayed, for the range of real numbers specified by
numBaseValue.
Returned value
0 Error
1 Success
Notes
If you call this function more than once with different parameters for each call, then you can build a
virtual table of format settings. You can set a different number of decimal places for each range of real
numbers, and all of the settings are saved for the duration of runtime or until you reset the table using the
ResetDecimalPointsTable function.
Note: This formatting does not change the actual value of any tag or expression. It only changes
how the value is displayed by on-screen objects.
Examples
Tag Name
Expression
Tag SetDecimalPoints( 1.5, 3 ) // Displays 3 decimal places for all real numbers greater than or equal to 1.5.
Tag SetDecimalPoints( −3, 1 ) // Displays 1 decimal place for all real numbers less than or equal to −3.
SetDisplayUnit
Finds all tags and all Grid object and Trend Control object values that have a specific engineering unit (as
stored in the Unit tag field), and then sets the DisplayUnit, UnitDiv, and UnitAdd fields on those tags.
Function Group Execution Windows Embedded Thin Client
SetDisplayUnit Graphic Synchronous Supported Supported Supported
Syntax
SetDisplayUnit(strUnitOrigin,strDisplayUnit,numDiv,numAdd)
strUnitOrigin
strDisplayUnit
numDiv
numAdd
The engineering unit to be matched.
The new value for the DisplayUnit tag field.
The new value for the UnitDiv tag field.
The new value for the UnitAdd tag field.
Returned value
0 Success.
-1 Wrong number of parameters.
-2 strUnitOrigin parameter is empty.
-3 numDiv parameter is invalid (equal to 0).
Page 652
InduSoft Web Studio