HS4Touch Elements
Documentation on using the HS4Touch Designer Elements
Overview
HS4Touch Elements are the building blocks for all screens. This document defines all the elements.
See HS4Touch Quick Start Guide for more context on using elements.
| Element | Description |
|---|---|
| Button | A graphic button is a control element with predefined graphics that may trigger actions when pressed or released. Graphic buttons may be accessed from the 'Buttons' tab of the Elements Palette. |
Slider | A slider is a control element with predefined graphics that's designed to change the value of a device or other control. Sliders may be accessed from the 'Sliders' tab of the Elements Palette. |
| Music | Music Groups are custom control groups that include music control elements. Music Groups may be accessed from the 'Music' tab of the Elements Palette. |
Thermostats | Thermostat Groups are custom control groups that include thermostat control elements. Thermostat Groups may be accessed from the 'Thermostats' tab of the Elements Palette. |
| Others (Text) | Text is a design element that's typically used to add a label or description to a screen. Text elements may be accessed from the 'Other' tab of the Elements Palette. |
| Others (Button) | A button is a control element without predefined graphics that may trigger actions when pressed or released. Button elements may be accessed from the 'Other' tab of the Elements Palette. |
| Others (Image) | An image is a design element used for displaying a new photo or other graphic. Once an image is created, it will be added to the 'Graphics' elements (defined below). Image elements may be accessed from the 'Other' tab of the Elements Palette. |
| Others (Group Box) | A group box is an element used to create custom groups. A custom group is a collection of control and/or design elements that work together in some fashion. Group box elements may be accessed from the 'Other' tab of the Elements Palette. |
| Others (Status Bar) | A status bar is a design element that's used to display the status of a device or other control. Status bars may be accessed from the 'Other' tab of the Elements Palette. The format may be either a horizontal/vertical bar, or a round gauge that uses a needle to indicate a value. When creating a gauge, set the "Style" property to "Gauge", set the background graphic for the gauge and the needle graphic. Sample gauges are located in the "My Documents\hstouch\Skins\Default\Gauges" folder. Set the max/min angle so the needle aligns properly with the max and min value. You can set the value property in order to determine the proper angle. The default gauge uses a min/max of -148 and 148 degrees. Set the min/max value that the gauge will display. The gauge can be associated with any HomeSeer device in order to display its value, such as a power monitor. |
| Others (Text Box) | A text box is a control element that allows text entry for use with other control or design elements. Text box elements may be accessed from the 'Other' tab of the Elements Palette. |
| Others (Drop List) | A drop list is a control element that allows a selection to be made from a predefined list. Drop list elements may be accessed from the 'Other' tab of the Elements Palette. |
| Others (List Box) | A list box is a control element that allows a selection to be made from a predefined list. List Box list elements may be accessed from the 'Other' tab of the Elements Palette. List boxes hold 2 items per entry, a name and a value. You can enter both of these manually from the properties pane, or you can associate a list box with a HomeSeer device. If the device has name/value pairs associated with it (you can tell if it does if it has a drop list of items on the HomeSeer status page), then the names and values will populate the list box automatically. When you select an item from the list, the device in HomeSeer automatically gets set to the new value. This may not always be desirable. At times you may want to display a list of items, but not affect the actual HomeSeer device. In these cases, check the box "Do not control associated device when element is selected". This will allow the user to make a selection, but the device in HomeSeer will not be changed. You can still send the selection to HomeSeer if needed so it can be processed by a script. To do this, add a new button to your screen and set the action to run a HomeSeer script. Select the script then set the parameter 1 to the list box you are using. When a user clicks on a selection, the selection is sent as parameter 1 to the script in HomeSeer. The parameter is formatted with both the selection name and its value, separated with a CHR(7) character. In HomeSeer, you can accept this parameter and process as needed. Here is a sample HomeSeer script named "process_list.txt": |
| Custom | A custom group is a predefined collection of control and/or design elements that work together in some fashion. Custom group elements may be accessed from the 'Custom' tab of the Elements Palette. |
| Graphics | A graphic is a design element consisting of a predefined image (defined above). Graphic elements may be accessed from the 'Graphics' tab of the Elements Palette. |
| Backgrounds | A background is a design element with a predefined graphic. Backgrounds will always occupy the bottom layer of the design screen and serve as backdrops for all of the other elements. Background elements may be accessed from the 'Background [height x width]' tabs of the Elements Palette. |
Need more help?
- Get support by creating a ticket here
- Community Support