Differences

This shows you the differences between two versions of the page.

--- xtension_manual:editunitdisplay [2017/02/24 13:45] – external edit 127.0.0.1
+++ xtension_manual:editunitdisplay [2018/04/11 15:02] – Added Control Type In LIst for version 9.4 James Sentman
@@ Line 3: / Line 3: @@
 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.
-{{ :xtension_manual:editunitdisplaysettings.png |}}
+{{ :xtension_manual:editunitdisplaysettings.png?nolink&600 |}}
 \\
@@ Line 14: / Line 17: @@
 \\
   * **ON Label** 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 [[dictionary:unitinformation:|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 [[xtension_manual:advancedlabel|Advanced Label Syntax]] for displaying combinations of data or selecting values from a list without writing any scripts at all.
+\\
+  * **Control Type In Lists** This sets the control type that you wish to display for this unit in any List windows or Web Remote Lists that it’s included in. The Toggle control is the default, other options are Buttons, Popup, Text Field and None. For a Popup control you must supply a comma separated list of the options that you wish to include in the popup. The value of the unit will select the corresponding entry in the list for display. Selecting a new popup value will set the value of the unit to it’s index. In the example above the Unit is an HVAC Mode unit with 3 valid values, 0 for off, 1 for heat and 2 for cool. Instead of having to remember that and set the value manually with this control you can select the text values from a popup and have the proper value be set. See [[xtension_manual:controllingunits|Controlling Unit From Lists]] for more info on using and configuring the Unit List Control Type. The control type was added in XTension version 9.4.
 \\
   * **Suffix** 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 [[dictionary:unitinformation:|Unit Of Measure]] property of the xUnit class.