Schalter

Ca. 3 Min. Lesezeit

TwSwitch · Kategorie: Schaltflächen

Touch-Panels

Ist der Schalter gesperrt, zeigt ein Tippen den Text aus Sperrgrund. Mit Bestätigung erforderlich trägt der Bestätigungsdialog den Titel und die Beschriftung des Zielzustands, z. B. „Pumpe 1 – EIN“ (Bestätigung). Code in onMouseDown und onMouseUp läuft auch auf Touchscreens (Ereigniscode bei Touch-Bedienung).

Einstellungen

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

Wert / Schreiben

Einstellung	Typ	Standardwert	Beschreibung
Wert ein onValue	Wert (mit Typauswahl)	true	Wert, der geschrieben wird, wenn Toggle/Switch eingeschaltet ist.
Wert aus offValue	Wert (mit Typauswahl)	false	Wert, der geschrieben wird, wenn Toggle/Switch AUS ist.
Prozesswert processValue	Wert (mit Typauswahl)	true	Basis-Lese-/Schreibwert. Wenn die Zustandsquelle Prozesswert ist, wird der visuelle Status aus diesem Wert berechnet.

Verhalten

Einstellung	Typ	Standardwert	Beschreibung
Schreibgeschützt readOnly	Kontrollkästchen	Aus	Wenn aktiv, kann der Benutzer den Wert zur Laufzeit nicht ändern.
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.

Beschriftungen / Symbole

Einstellung	Typ	Standardwert	Beschreibung
Beschriftung ein onLabel	Text	ON	Text auf dem Schalter im eingeschalteten Zustand. Die Schriftgröße richtet sich nach der längeren Beschriftung.
Beschriftung aus offLabel	Text	OFF	Text auf dem Schalter im ausgeschalteten Zustand. Die Schriftgröße richtet sich nach der längeren Beschriftung.

Darstellung

Einstellung	Typ	Standardwert	Beschreibung
Klasse des Eingabefelds inputClass	CSS-Klassen	—	CSS-Klassen, die dem Schalterelement hinzugefügt werden.
Knopffarbe knobColor	Farbe	—	Farbe des Knopfs im eingeschalteten Zustand. Leer verwendet die Aus-Knopffarbe, sonst die Vordergrundfarbe (standardmäßig weiß).
Knopffarbe (aus) knobOffColor	Farbe	—	Farbe des Knopfs im ausgeschalteten Zustand. Leer verwendet die Ein-Knopffarbe, sonst die Vordergrundfarbe (standardmäßig weiß).

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, onClick, onMouseDown, onMouseUp, lockReason, processValue, readOnly, inputClass, needsConfirmation, onLabel, offLabel, onValue, offValue, knobColor, knobOffColor

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

Gemeinsame Abschnitte

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