Kontrollkästchen

Ca. 2 Min. Lesezeit

TwCheckBox · Kategorie: Basis

Einstellungen

Diese Einstellungen finden Sie bei ausgewähltem Widget rechts im Eigenschaftenbereich, meist im Abschnitt Kontrollkästchen-Einstellungen. 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)	-1	Hauptwert des Widgets, meist in Bindings an einen Tag oder einen Ausdruck gebunden.

Verhalten

Einstellung	Typ	Standardwert	Beschreibung
Schreibgeschützt readOnly	Kontrollkästchen	Ein	Wenn aktiv, kann der Benutzer den Wert zur Laufzeit nicht ändern.
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
Text text	Text	—	Neben dem Kästchen angezeigter Text. Leer zeigt nur das Kästchen.
Symbolgröße (px) iconSize	Zahl	—	Größe des Kästchens in Pixel. Werte unter 10 werden ignoriert und die Standardgröße verwendet.
Hinweis hint	Text	—	Tooltip-Text, der zur Laufzeit angezeigt wird, wenn der Mauszeiger auf dem Widget verweilt.
Symbolquelle (aktiviert) checkedIconSrc	Datei	—	Bild, das im aktivierten Zustand statt des Kästchens angezeigt wird. Ist nur ein Bild gesetzt, gilt es für beide Zustände.
Symbolquelle (deaktiviert) uncheckedIconSrc	Datei	—	Bild, das im deaktivierten Zustand statt des Kästchens angezeigt wird. Ist nur ein Bild gesetzt, gilt es für beide Zustände.

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, readOnly, needsConfirmation, hint, text, iconSize, onValue, offValue, processValue, onChange, checkedIconSrc, uncheckedIconSrc

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.