Documentation
SelectColor
Require: IP-Symcon >= 4.2
Creates a selection dialog with the caption caption.
If created in the "elements" area, the property name is set to the value as hex string of the selected color when accepted.
If the value is deleted, it is set to transparent(value = -1).
Parameters
| Parameter | Description |
|---|---|
| allowTransparent (optional) | (default: true) If set, the selection can be deleted and thereby set to "transparent". Otherwise the value cannot be deleted and therefore cannot be set to "transparent". |
| caption | Visible caption |
| download (optional) | (default: "") If this parameter is not an empty string and the output of the onChange script is a Data-URL, the output is downloaded as a text file with the name of the download parameter. (since Symcon 7.0) |
| enabled (optional) | (default: true) If true, the selection can be used, otherwise it is displayed as deactivated (since Symcon 5.2) |
| link (optional) | (default: false) If this parameter is true, the output of the onChange script is opened as a link. If it is false, the output is displayed as a dialog in the configuration form. (since Symcon 6.0) |
| name (optional) | Name of the selection/the property to be set |
| onChange (optional) | (default: "") Script which is executed when the color is changed. If the script consists of several lines, the individual lines can also be defined as an array (arrays are supported since version 6.0). It has the same properties as onClick of the Button. (since Symcon 5.2) |
| transparentCaption | (default: "Transparent") Caption that is shown when the selection is set to "transparent", i.e., -1 (since Symcon 8.2) |
| type | SelectColor |
| value (optional) | (default: -1 if allowTransparent, otherwise 0) The value of the selection - If there is an associated property, this parameter is overwritten by the property in the elements area (since Symcon 5.2) |
| visible (optional) | (default: true) If true, the selection is visible, otherwise it is invisible (since Symcon 5.2) |
| width (optional) | (default: 300px) Fixed width of the color selection in pixels or % as a string, e.g. "40%" or "250px" (since Symcon 5.3) |
Example
{ "type": "SelectColor", "name": "HexColorProperty", "caption": "Color" }