Dokumentation
RadioButtonGroup
Benötigt: Symcon >= 9.1
Erstellt eine Gruppe von Radio Buttons mit der Überschrift caption.
Falls im "elements"-Bereich erstellt, setzen die Buttons eine Eigenschaft bei Übernahme auf den ausgewählten Wert value.
Der Parameter "name" definiert dabei welche Eigenschaft gesetzt wird.
Bei MultiSelect ist darauf zu achten, dass alle Value-Arrays die gleichen Namen beinhalten
Wird RadioButtonGroup innerhalb von Listen verwendet, gibt es kein MultiSelect.
Parameter
| Parameter | Beschreibung |
|---|---|
| caption | Sichtbare Beschriftung der Gruppe von Radio Buttons |
| download (optional) | (default: "") Ist dieser Parameter nicht leer und beinhaltet die Ausgabe des onChange-Skriptes eine Data-URL, so wird die Rückgabe als Textdatei mit dem Namen das download-Parameters heruntergeladen. |
| enabled (optional) | (default: true) Bei true kann die Gruppe verwendet werden, ansonsten wird sie deaktiviert dargestellt |
| link (optional) | (default: false) Ist dieser Parameter true, dann wird die Ausgabe des onChange-Skriptes als Link geöffnet. Ist er false, so wird die Ausgabe als Dialog im Konfigurationsformular angezeigt. |
| name (optional) | Name der Gruppe/der zu setzenden Eigenschaft |
| options | Array, welches alle Auswahlmöglichkeiten beinhaltet |
| onChange (optional) | (default: "") Skript, welches bei Auswahl eines Radio Buttons ausgeführt wird. Sofern das Skript aus mehreren Zeilen besteht, können die einzelnen Zeilen auch als Array übergeben werden. Es hat die gleichen Eigenschaften wie onClick des Button |
| type | RadioButtonGroup |
| value (optional) | (default: erste definierte Option) Der Wert des gewählten Radio Buttons - Sofern es eine dazugehörige Eigenschaft gibt, wird dieser Parameter im elements-Bereich durch die Eigenschaft überschrieben |
| visible (optional) | (default: true) Bei true ist die Gruppe sichtbar, ansonsten ist sie unsichtbar |
| width (optional) | (default: 300px) Feste Breite der Gruppe in Pixel oder % als String, z.B. "40%" oder "250px" |
Parameter für options
| Parameter | Beschreibung |
|---|---|
| caption | Beschriftung eines Radio Buttons |
| enabled (optional) | (default: true) Bei true ist der Radio Button aktiv und wählbar, ansonsten wird er inaktiv dargestellt und kann nicht gewählt werden |
| value | Wert der bei Auswahl übergeben wird. Kann auch ein weiteres Array beinhalten, welches mehreren Eigenschaften die Werte übergibt. |
Beispiel
//Einfache Valueübergabe
//Eigenschaft "DeviceType" wird auf 0..3 gesetzt
//Gruppe hat 4 Radio Buttons
{ "type": "RadioButtonGroup", "name": "DeviceType", "caption": "Einheit",
"options": [
{ "caption": "Bit (1Bit)", "value": 0 },
{ "caption": "Bits (2Bit)", "value": 1 },
{ "caption": "Bits (4Bit)", "value": 2 },
{ "caption": "Byte (8Bit)", "value": 3 }
]
}
//Mehrfache Valueübergabe (MultiSelect)
//"name" der RadioButtonGroup (hier: "OutputDevice") muss gesetzt sein, wird jedoch nicht zum Setzen der Werte genutzt.
//Eigenschaften "DeviceName", "DeviceChannels" und "DeviceNum" werden gesetzt.
{ "type": "RadioButtonGroup", "name": "OutputDevice", "caption": "Ausgabegerät",
"options": [
{"caption" : "No sound",
"value": [
{"name": "DeviceName", "value": "No sound"},
{"name": "DeviceChannels", "value": 0},
{"name": "DeviceNum", "value": 0}
]
},
{"caption" : "Kopfhörer",
"value": [
{"name": "DeviceName", "value": "Kopfhörer"},
{"name": "DeviceChannels", "value": 2},
{"name": "DeviceNum", "value": 1}
]
},
{"caption" : "Lautsprecher",
"value": [
{"name": "DeviceName", "value": "Stereolautsprecher"},
{"name": "DeviceChannels", "value": 2},
{"name": "DeviceNum", "value": 2}
]
}
]
}