Potentiometer

Ca. 5 Min. Lesezeit

TwPotentiometer · Kategorie: Basis

Sperranzeige

Ab 2.11.0 wird das Potentiometer 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 Drehknopf. Ein Potentiometer, dessen Sollwert an keinen Tag gebunden ist, zeigt nur einen Wert an und sieht normal aus. Siehe Gesperrte Bedienelemente.

Einstellungen

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

Wert

Einstellung	Typ	Standardwert	Beschreibung
Sollwert (Process Value) processValue	Zahl	0	Sollwert. Binden Sie ihn an den Tag, der den Wert erhält; der Drehknopf schreibt ihn dorthin. Ohne Bindung ist dies der im Editor angezeigte Wert.
Rückmeldewert feedbackValue	Zahl	—	Optionaler Istwert. Wenn gebunden, zeigen Knopf und Anzeige diesen Wert und eine kleine Markierung den Sollwert.
Minimalwert minValue	Zahl	0	Wert am Anfang der Skala. Der geschriebene Wert wird nie kleiner.
Schrittweite step	Zahl	1	Der Wert rastet auf Vielfache dieser Schrittweite ab dem Minimalwert ein. 0 oder leer bedeutet stufenlos.
Einheit unit	Text	—	Einheit hinter dem Wert, z. B. %, bar oder rpm.
Maximalwert maxValue	Zahl	100	Wert am Ende der Skala. Der geschriebene Wert wird nie größer.
Nachkommastellen decimals	Zahl	0	Anzahl der angezeigten und geschriebenen Nachkommastellen (0 bis 6).
Einheit aus Tag unitFromTag	Kontrollkästchen	Aus	Zeigt statt Einheit die Einheit aus der Tag-Definition der Rückmeldewert-Bindung, sonst der Sollwert-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.

Verhalten

Einstellung	Typ	Standardwert	Beschreibung
Schreibgeschützt readOnly	Kontrollkästchen	Aus	Wenn aktiviert, zeigt das Potentiometer den Wert nur an und kann zur Laufzeit nicht gedreht werden.
Sperrgrund lockReason	Text	—	Optional. Solange der Drehknopf 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.
Schreibmodus writeMode	Auswahl	onRelease	Beim Loslassen schreibt nur den Endwert. Beim Drehen schreibt auch Zwischenwerte, höchstens einmal pro Schreibintervall. Ein abgebrochenes Drehen (Escape, verlorener Zeiger) schreibt den Startwert zurück. Optionen: onRelease Beim Loslassen, throttled Beim Drehen (gedrosselt)
Mausrad wheelEnabled	Kontrollkästchen	Aus	Erlaubt das Ändern des Werts mit dem Mausrad, ein Schritt pro Raste. Der Wert wird nach einer kurzen Pause geschrieben.
Bestätigung erforderlich needsConfirmation	Kontrollkästchen	Aus	Fragt pro Drehung (Ziehen, Tastendruck oder Mausrad-Pause) einmal nach, bevor der Endwert geschrieben wird. Zwischenwerte werden nie geschrieben.
Schreibintervall (ms) throttleInterval	Zahl	250	Mindestabstand zwischen Zwischenwerten im Modus Beim Drehen (100 bis 5000 ms).

Skala

Einstellung	Typ	Standardwert	Beschreibung
Startwinkel startAngle	Zahl	-135	Knopfwinkel des Minimalwerts in Grad; 0 zeigt nach oben, positive Werte drehen im Uhrzeigersinn (Standard -135).
Hauptstriche majorTicks	Zahl	6	Anzahl der beschrifteten Hauptstriche einschließlich beider Enden (2 bis 21).
Skalenbeschriftung anzeigen showScaleLabels	Kontrollkästchen	Ein	Zeigt die Werte neben den Hauptstrichen.
Größe der Skalenbeschriftung scaleLabelSize	Zahl	15	Schriftgröße der Skalenbeschriftung, 10–28 (Standard 15). Die Beschriftung skaliert mit dem Widget; bei kleinen Widgets den Wert erhöhen, damit sie lesbar bleibt. Bei vielen Hauptstrichen können sich große Werte überlappen.
Drehbereich sweepAngle	Zahl	270	Winkel im Uhrzeigersinn vom Minimalwert bis zum Maximalwert (30 bis 340 Grad, Standard 270).
Zwischenstriche minorTicks	Zahl	4	Anzahl der kleinen Striche zwischen zwei Hauptstrichen (0 bis 9).
Wert anzeigen showValue	Kontrollkästchen	Ein	Zeigt den aktuellen Wert mit Einheit unter dem Knopf.
Wertgröße readoutSize	Zahl	26	Schriftgröße der Wertanzeige, 14–34 (Standard 26). Lange Werte werden gestaucht, damit sie unter die Skala passen.

Darstellung

Einstellung	Typ	Standardwert	Beschreibung
Beschriftung caption	Text	—	Text unten am Potentiometer. Lange Beschriftungen werden passend gestaucht.
Beschriftungsstil labelStyle	Text	—	Zusätzliches CSS für die Beschriftung, z. B. fill: #c00; font-size: 18px.
Beschriftungsgröße captionSize	Zahl	15	Schriftgröße der Beschriftung, 10–24 (Standard 15). Eine größere Beschriftung schiebt die Wertanzeige nach oben. Eine font-size im Beschriftungsstil hat Vorrang.
Akzentfarbe accentColor	Farbe	—	Farbe des Wertebogens, der Sollwertmarkierung und des Fokusrahmens. Leer lassen für die Akzentfarbe des Themas.

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, feedbackValue, minValue, maxValue, step, decimals, unit, unitFromTag, startAngle, sweepAngle, majorTicks, minorTicks, showScaleLabels, scaleLabelSize, readoutSize, captionSize, showValue, writeMode, throttleInterval, wheelEnabled, needsConfirmation, readOnly, caption, accentColor

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.