Dokumentation
SelectFile
Benötigt: IP-Symcon >= 4.2
Erstellt einen Auswahldialog mit der Beschriftung caption.
Falls im "elements"-Bereich erstellt, wird bei Übernahme die Eigenschaft name auf den Base64 kodierten Wert der ausgewählten Datei gesetzt. Dies bedeutet, dass der Inhalt der ausgewählten Datei als Base64 kodierter String gespeichert wird.
Parameter
| Parameter | Beschreibung |
|---|---|
| caption | Sichtbare Beschriftung |
| 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. (ab IP-Symcon 7.0) |
| enabled (optional) | (default: true) Bei true kann die Dateiauswahl verwendet werden, ansonsten wird sie deaktiviert dargestellt (ab IP-Symcon 5.2) |
| extensions (optional) | Erlaubte Erweiterungen der Datei. Durch Komma getrennt und mit Punkt eingeleitet Bsp: .jpg,.gif,.txt |
| 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. (ab IP-Symcon 6.0) |
| name (optional) | Name der Dateiauswahl/der zu setzenden String-Eigenschaft |
| onChange (optional) | (default: "") Skript, welches bei einer Veränderung des Wertes der Dateiauswahl ausgeführt wird. Sofern das Skript aus mehreren Zeilen besteht, können die einzelnen Zeilen auch als Array übergeben werden (Arrays werden ab Version 6.0 unterstützt). Es hat die gleichen Eigenschaften wie onClick des Button (ab IP-Symcon 5.2) |
| type | SelectFile |
| value (optional) | (default: 0) Der Wert der Dateiauswahl - Sofern es eine dazugehörige Eigenschaft gibt, wird dieser Parameter im elements-Bereich durch die Eigenschaft überschrieben (ab IP-Symcon 5.2) |
| visible (optional) | (default: true) Bei true ist die Dateiauswahl sichtbar, ansonsten ist sie unsichtbar (ab IP-Symcon 5.2) |
| width (optional) | (default: 300px) Feste Breite der Dateiauswahl in Pixel oder % als String, z.B. "40%" oder "250px" (ab IP-Symcon 5.3) |
Beispiel
{ "type": "SelectFile", "name": "PropertyStringFile", "caption": "Target", "extensions": ".jpg,.gif,.txt" }