« Zurück zu Produkt

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,
        ]
    ])
]);
Haben Sie noch Fragen?