Umschaltfläche

Ca. 4 Min. Lesezeit

TwToggleButton · Kategorie: Schaltflächen

Touch-Panels

Ist die Umschaltfläche gesperrt, zeigt ein Tippen den Text aus Sperrgrund. Mit Bestätigung erforderlich trägt der Bestätigungsdialog die Beschriftung der Schaltfläche (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)	false	Basis-Lese-/Schreibwert. Wenn die Zustandsquelle Prozesswert ist, wird der visuelle Status aus diesem Wert berechnet.
Aktionsmodus actionMode	Auswahl	write	Schreiben: schreibt nur den Prozesswert, Link: löst nur die Link-Aktion aus, Schreiben und Link: schreibt zuerst und löst dann den Link aus. Optionen: write Schreiben, link Link, writeAndLink Schreiben und Link
Zustandsquelle stateMode	Auswahl	processValue	Prozesswert: Der Zustand wird aus dem Tag-Wert gelesen. Lokal: Der Zustand wechselt bei jedem Klick nur in der Oberfläche (unabhängig vom Tag). Optionen: processValue Prozesswert, local Lokal

Verhalten

Einstellung	Typ	Standardwert	Beschreibung
Schreibgeschützt readOnly	Kontrollkästchen	Ein	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
Symbolmodus iconMode	Auswahl	auto	Automatisch: bevorzugt das Bild (IconSrc), sonst das CSS-Klassensymbol. CSS-Klasse: nur Klassensymbol. Bild: nur IconSrc (fällt auf das Klassensymbol zurück, wenn es leer ist). Optionen: auto Automatisch, class CSS-Klasse, image Bild
Symbol ein onIcon	Symbol	check	Klassensymbol, das im EIN-Zustand verwendet wird.
Symbol aus offIcon	Symbol	close	Klassensymbol, das im AUS-Zustand verwendet wird.
Symbolquelle ein onIconSrc	Datei	—	Dateibasierter Symbolpfad, der im EIN-Status verwendet wird.
Symbolquelle aus offIconSrc	Datei	—	Dateibasierter Symbolpfad, der im AUS-Zustand verwendet wird.
Hinweis hint	Text	—	Tooltip-Text, der zur Laufzeit angezeigt wird, wenn der Mauszeiger auf dem Widget verweilt.
Icon Pos iconPos	Text	left	Das Symbol steht immer vor dem Text.

Darstellung

Einstellung	Typ	Standardwert	Beschreibung
Styling Mode stylingMode	Text	outlined	Gefüllt füllt die Schaltfläche mit Farbe, Umrandet zeigt nur einen Rahmen (Standard), Text zeigt weder Rahmen noch Hintergrund.
Type type	Text	normal	Schaltflächenfarbe aus dem Theme: Normal ist neutral, Standard nutzt die Akzentfarbe, Erfolg ist grün und Gefahr rot.
Button Class buttonClass	Text	—	CSS-Klassen, die dem Schaltflächenelement hinzugefügt werden.

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, to.type, lockReason, readOnly, needsConfirmation, processValue, onValue, offValue, onIcon, offIcon, iconMode, actionMode, stateMode, onIconSrc, offIconSrc, buttonClass, hint, iconPos, stylingMode

Gemeinsame Abschnitte

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