The Display tab of the Edit Unit Window controls how the unit is displayed, how it’s values and labels are formatted and displayed and any colors or icons associated with the Unit.
this is a large user field that can contain any information about the unit that you wish. Clicking the “…” button to the right brings up a larger edit sheet to make it easier to type larger amounts of information in this field. You can access the Description via the Set Description Of
verb, or get the description via the Description Of
verb. The description can be displayed in any unit List window. It can also be displayed in Views and Web Remote pages as well as used to create custom controls for both interfaces by including simple or even very complicated HTML
and OFF Label
if you wish to display some other label than ON/OFF or the units value you can assign those values here. For a door sensor you may wish to display OPEN or CLOSED. The values of both these fields can be accessed and changed by scripts using the xtOnLabel and xtOffLabel
properties of the xUnit object. The labels are displayed anywhere the value of a unit would be displayed and also in Views or Web Remote displays. The labels can also include very versatile Advanced Label Syntax
for displaying combinations of data or selecting values from a list without writing any scripts at all.
sometimes also called the “Unit Of Measure” this is just appended to the end of the formatted value display where it’s used. In the example above it’s just a “w” for watts. If it’s a temperature sensor you might wish to append “°F” to the end of the value. Suffix is available to scripts through the Unit Of Measure
property of the xUnit class.
The Format string contains information for how to format the numbers. This uses the same syntax as the Format Number
verb and can be used to limit decimal points or add commas or any number of useful functions. This is accessable to scripts via the xtFormatString
property of the xUnit class.
If you have graphics that you would like to use to represent units place them into the “Icons” folder which is created alongside the XTension dictionary and they will be available here. Click either image well to set or change the icon. You will be presented with a list of graphics files found in that folder to choose from. You can set the icons via scripting using the Set On Icon For
and Set Off Icon For
verbs and pass the name of the file. Unit icons can be displayed in lists as well as unit icon controls in Views and the Web Remotes.
Custom Background Color
by default XTension uses green to show a unit that is in it’s OFF state, and red to indicate a unit in it’s ON state. You can setup custom colors for each state that will show in list views as well as View and Web Remote controls for this unit here. You can also change the values from a script using the xtOnColor
properties of the xUnit object.
PREVIOUS Edit Unit Dialog
NEXT Edit Unit Dialog - XTdb tab