Dokumentation
Schieberegler
Benötigt: Symcon >= 8.0
Parameter
Informationen zu den visuellen Eigenschaften und Bedeutungen der Parameter sind in der Objekt-Darstellung zu finden.
| Name | Typ | Parameter | Beschreibung |
|---|---|---|---|
| PRESENTATION | String | Die ID der Darstellung | VARIABLE_PRESENTATION_SLIDER {6B9CAEEC-5958-C223-30F7-BD36569FC57A} |
| MIN | Integer/Float | Minimaler Wert | |
| MAX | Integer/Float | Maximaler Wert | |
| STEP_SIZE | Integer/Float | Schrittweite | |
| GRADIENT_TYPE | Integer | Gradient | 0: Standard, 1: Temperatur, 2: Farbtemperatur, 3: Benutzerdefiniert |
| CUSTOM_GRADIENT | String | Benutzerdefinierter Gradient | JSON-kodierte Liste von Objekten mit den Parametern 'Value' und 'Color', wobei Color analog zu SelectColor codiert wird |
| USAGE_TYPE | Integer | Verwendung der Variable | 0: Temperatur, 1: Farbtemperatur, 2: Intensität, 3: Lautstärke, 4: Fortschritt, 5: Keine hiervon |
| PREFIX | String | Präfix | |
| SUFFIX | String | Suffix | |
| PERCENTAGE | Boolean | Anzeigetyp | false: Absolut, true: Prozentual |
| THOUSANDS_SEPARATOR | String | Tausendertrennzeichen | Client: Standard vom Nutzer, sonst direkt der Wert |
| DIGITS | Integer | Nachkommastellen | |
| DECIMAL_SEPARATOR | String | Dezimaltrennzeichen | Client: Standard vom Nutzer, sonst direkt der Wert |
| ICON | String | Icon | |
| INTERVALS_ACTIVE | Boolean | Verwende aktualisierte Parameter für spezifische Intervalle | |
| INTERVALS | String | Intervalle | JSON-kodierte Liste von Objekten, die genauen Parameter sind unter Intervalle beschrieben |
Intervalle
| Name | Typ | Parameter | Beschreibung |
|---|---|---|---|
| IntervalMinValue | Integer/Float | Anfang des Intervalls | |
| IntervalMaxValue | Integer/Float | Ende des Intervalls | |
| ConstantActive | Boolean | Anzeige | false: Formatierter Wert, true: Konstante |
| ConstantValue | String | Konstante | |
| ConversionFactor | Integer/Float | Umrechnungsfaktor | |
| PrefixActive | Boolean | Überschreibe Präfix | |
| PrefixValue | String | Präfix | |
| SuffixActive | Boolean | Überschreibe Suffix | |
| SuffixValue | String | Suffix | |
| DigitsActive | Boolean | Überschreibe Nachkommastellen | |
| DigitsValue | Integer | Nachkommastellen | |
| IconActive | Boolean | Überschreibe Icon | |
| IconValue | String | Icon |
Vorlagen
// Registriert eine Variable mit einer Raumtemperatur Vorlage.
$this->RegisterVariableFloat('TargetValue', 'Sollwert', [
'PRESENTATION' => VARIABLE_PRESENTATION_SLIDER,
'TEMPLATE' => VARIABLE_TEMPLATE_SLIDER_ROOM_TEMPERATURE,
]);
| Name | Konstante | GUID |
|---|---|---|
| Raumtemperatur | VARIABLE_TEMPLATE_SLIDER_ROOM_TEMPERATURE | {868B087E-A38D-2155-EBE0-157AFBBF9E8C} |
| Farbtemperatur | VARIABLE_TEMPLATE_SLIDER_COLOR_TEMPERATURE | {66062309-21A9-26C0-213F-775C52E1473B} |
| Energie | VARIABLE_TEMPLATE_SLIDER_ENERGY | {BC799412-0C66-551F-CAEC-7566F5D52BD9} |
| Leistung | VARIABLE_TEMPLATE_VALUE_PRESENTATION_BATTERY | {8EC19DF0-89FB-A77E-ED7D-047A949CF292} |
Beispiele
// Beim Registrieren einer Variable für PHP-Module
// Ein Schieberegler, mit einer spanne von 0 - 2000W. Ab 1000 W wird der Wert als kW angezeigt.
$this->RegisterVariableInteger('Leistung', 'Leistung', [
'PRESENTATION' => VARIABLE_PRESENTATION_SLIDER,
'ICON' => 'bolt',
'SUFFIX' => ' W',
'MIN' => 0,
'MAX' => 2000,
'INTERVALS_ACTIVE' => true,
'INTERVALS' => json_encode([
[
'IntervalMinValue' => 1000,
'IntervalMaxValue' => 999999,
'ConversionFactor' => 1000,
'SuffixActive' => true,
'SuffixValue' => ' kW',
'DigitsActive' => true,
'DigitsValue' => 2,
'ConstantActive' => false,
'PrefixActive' => false,
]
])
]);
// Für bestehende Variablen via Skript
// Ein Schieberegler, mit einer spanne von 0 - 2000W. Ab 1000 W wird der Wert als kW angezeigt.
IPS_SetVariableCustomPresentation(12345, [
'PRESENTATION' => VARIABLE_PRESENTATION_SLIDER,
'ICON' => 'bolt',
'SUFFIX' => ' W',
'MIN' => 0,
'MAX' => 2000,
'INTERVALS_ACTIVE' => true,
'INTERVALS' => json_encode([
[
'IntervalMinValue' => 1000,
'IntervalMaxValue' => 999999,
'ConversionFactor' => 1000,
'SuffixActive' => true,
'SuffixValue' => ' kW',
'DigitsActive' => true,
'DigitsValue' => 2,
'ConstantActive' => false,
'PrefixActive' => false,
]
])
]);