Drehschalter

Ca. 3 Min. Lesezeit

TwRotarySwitch · Kategorie: Basis

Sperranzeige

Ab 2.11.0 wird der Drehschalter abgeblendet und mit Schloss angezeigt, wenn Schreibgeschützt an einen Tag gebunden ist, dessen Wert wahr ist, oder dem Benutzer die Berechtigung fehlt. Ist ein Sperrgrund eingetragen, erscheint er beim Tippen auf den gesperrten Drehschalter. Siehe Gesperrte Bedienelemente.

Einstellungen

Diese Einstellungen finden Sie bei ausgewähltem Widget rechts im Eigenschaftenbereich, meist im Abschnitt Drehschalter-Einstellungen. Der Standardwert ist der Wert, den das Widget beim ersten Einfügen in eine Seite hat.

Verhalten

Einstellung	Typ	Standardwert	Beschreibung
Schreibgeschützt readOnly	Kontrollkästchen	Aus	Wenn aktiv, kann der Wahlschalter zur Laufzeit nicht bedient werden. Ohne diese Einstellung gespeicherte Widgets sind schreibgeschützt.
Anderes Tag invertieren invertOtherTag	Kontrollkästchen	Aus	Bei getrennten Tags für On Value und Off Value wird zusätzlich der invertierte boolesche Wert in das andere Tag geschrieben, damit beide konsistent bleiben.
Sperrgrund lockReason	Text	—	Optional. Solange das Steuerelement zur Laufzeit gesperrt ist (Schreibgeschützt an ein Tag gebunden, das wahr ist, oder Benutzer ohne Schreibrecht), zeigt ein Tippen diesen Text kurz anstelle der Berechtigungsmeldung an; er erscheint auch als Tooltip. Beispiel: „Verriegelung: Tür offen“. Ein Sprachschlüssel wird übersetzt. Leer lässt das Verhalten unverändert.
Bestätigung erforderlich needsConfirmation	Kontrollkästchen	Aus	Fragt vor dem Schreiben des Werts in den Tag nach einer Bestätigung.

Werte

Einstellung	Typ	Standardwert	Beschreibung
Wert ein onValue	Wert (mit Typauswahl)	true	Wert, der in das an On Value gebundene Tag geschrieben wird. Der Knopf zeigt On, wenn das Tag diesem Wert entspricht.
Wert aus offValue	Wert (mit Typauswahl)	—	Wert der Off-Stellung. Leer lassen, um das Gegenteil eines booleschen On Value in dasselbe Tag zu schreiben.

Beschriftungen

Einstellung	Typ	Standardwert	Beschreibung
Beschriftung ein labelOn	Text	AUTO	Text der Ein-Position rechts vom Drehschalter. Lange Texte werden passend gestaucht.
Beschriftungen labelVisibility	Auswahl	always	Sichtbarkeit der Positionsbeschriftungen. Immer anzeigen: Standard. Bei kleiner Größe ausblenden: Unter 72 px werden die Beschriftungen ausgeblendet und der Knopf wird größer. Ausblenden: Beschriftungen werden nie angezeigt. Optionen: always Immer anzeigen, auto Bei kleiner Größe ausblenden, hidden Ausblenden
Beschriftungsstil labelStyle	Text	—	Zusätzliches CSS für beide Beschriftungen, z. B. fill: #c00; font-size: 28px. Lange Beschriftungen werden passend gestaucht.
Beschriftung aus labelOff	Text	MAN	Text der Aus-Position links vom Drehschalter. Lange Texte werden passend gestaucht.

Weitere Einstellungen

Einstellung	Typ	Standardwert	Beschreibung
Enable Flashing enableFlashing	Kontrollkästchen	Aus	Lässt das Widget blinken (ein Transparenzimpuls pro Sekunde). Wird meist an eine Alarmbedingung gebunden.
Log Button logButton	Kontrollkästchen	Aus	Zeigt zur Laufzeit beim Überfahren des Widgets ein Diagrammsymbol; ein Klick fügt die an das Widget gebundenen Tags der Log-Tag-Liste hinzu.

Bindungen

Im Abschnitt Bindungen (Regeln) des Eigenschaftenbereichs kann ein Tag mit einer Direct-Bindung an die folgenden Eigenschaften dieses Widgets gebunden werden. Die Bindungstypen (Direct, IntRange, FloatRange, Boolean, Bit) sind für alle Widgets gleich; sie werden auf der Seite Widget-Referenz beschrieben.

title, visible, authorization, x, y, width, height, rotation, class, foregroundColor, backgroundColor, borderColor, borderStyle, borderWidth, borderRadius, borderTopLeftRadius, borderTopRightRadius, enableFlashing, logButton, lockReason, readOnly, labelOn, labelOff, labelVisibility, onValue, offValue, needsConfirmation, invertOtherTag

Zusätzlich können die Stilfelder des Widgets als style.<feld> gebunden werden (z. B. style.left, style.top).

Gemeinsame Abschnitte

Bei ausgewähltem Widget zeigt der Eigenschaftenbereich außerdem diese gemeinsamen Abschnitte: Allgemein, Layout, Aussehen, Bindungen (Regeln). Diese Abschnitte werden auf der Seite Seiteneditor beschrieben.