Werteingabe

Ca. 3 Min. Lesezeit

TwValueEdit · Kategorie: Basis

Touch-Panels

Ist die Werteingabe gesperrt, zeigt ein Tippen den Text aus Sperrgrund; siehe Sperrgrund.

Einstellungen

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

Wert

Einstellung	Typ	Standardwert	Beschreibung
Prozesswert processValue	Wert (mit Typauswahl)	99.9	Hauptwert des Widgets, meist in Bindings an einen Tag oder einen Ausdruck gebunden.
Einheit unit	Text	—	Im Feld nach der Zahl angezeigte Einheit, z. B. bar.
Nachkommastellen fractionDigits	Zahl	1	Anzahl der immer angezeigten Nachkommastellen (0–7).
Einheit aus Tag unitFromTag	Kontrollkästchen	Aus	Zeigt im Feld nach der Zahl statt Einheit die Einheit aus der Tag-Definition der Prozesswert-Bindung (Direct). In einem gemeinsamen Modal gilt das Tag-Präfix des Modals. Einheit wird verwendet, wenn der Tag keine Einheit hat, und im Editor. Nur ein einfacher Tag-Name oder ein einzelner Tag in einfachen Anführungszeichen zählt; bei einem berechneten Ausdruck wie 'Durchfluss' / 1000 bleibt Einheit.
Schrittweite step	Zahl	1	Betrag, den die Plus-/Minus-Schaltflächen und die Pfeiltasten addieren oder abziehen. Standard 1.

Grenzwerte

Einstellung	Typ	Standardwert	Beschreibung
Untergrenze limitMin	Zahl	—	Kleinster Wert, der geschrieben werden kann. Kleinere Eingaben werden mit einer Warnung abgelehnt; leer bedeutet keine Untergrenze.
Obergrenze limitMax	Zahl	—	Größter Wert, der geschrieben werden kann. Größere Eingaben werden mit einer Warnung abgelehnt; leer bedeutet keine Obergrenze.

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.

Darstellung

Einstellung	Typ	Standardwert	Beschreibung
Klasse des Eingabefelds inputClass	CSS-Klassen	—	CSS-Klassen, die dem Eingabefeld hinzugefügt werden.
Schaltflächen anzeigen showButtons	Kontrollkästchen	Aus	Zeigt Schaltflächen, die den Wert um Step erhöhen und verringern; jeder Klick schreibt den neuen Wert.
Schaltflächenanordnung buttonLayout	Auswahl	horizontal	Anordnung der Schaltflächen: Gestapelt zeigt kleine Auf-/Ab-Pfeile rechts, Horizontal Minus links und Plus rechts, Vertikal ordnet sie senkrecht an. Optionen: stacked Gestapelt, horizontal Horizontal, vertical Vertikal

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, processValue, fractionDigits, needsConfirmation, readOnly, unit, unitFromTag, limitMin, limitMax, step, inputClass, showButtons, buttonLayout

Zusätzlich können die Stilfelder des Widgets als style.<feld> gebunden werden (z. B. style.width, style.height, 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.