TextVarIn

Ein-/Ausgabefeld für einen alphanumerischen Prozessvariablenwert.

Symbol
Menüband	Start > Steuerelemente > Ein-/Ausgabe > Variableneingabe > TextVarIn

Über das Steuerelement "TextVarIn" überträgt einen alphanumerischen Prozessvariablenwert zwischen Applikationsoberfläche und Variablenserver.

Beispiel: Das TextVarIn kann zur Eingabe von Text oder Passwörtern verwendet werden. Im letzteren Fall werden die eingegebenen Zeichen durch Punkte maskiert.

TextVarIn mit Texteingabe und TextVarIn mit Passworteingabe

Funktionalitäten

Das Steuerelement unterstützt folgende Funktionalität:

• Anbindung an eine spezifische Prozessvariable für die Datenquelle

• Pufferung von Benutzereingaben zum verzögerten Beschreiben einer Prozessvariablen

• Darstellung eines Fehlersymbols und eines Fehlertextes im Falle der Überschreitung von Eingabegrenzen

• Darstellung eines sprachumschaltbaren Textes für die Beschriftung

• Darstellung eines sprachumschaltbaren Hilfetextes

• Darstellung von Grafiken im Steuerelement

• Darstellung des Eingabefelds

• Verwendung einer Bildschirmtastatur

  Die Eigenschaft UseTouchKeyboard legt fest, ob die Bildschirmtastatur zur Zeicheneingabe geöffnet wird, wenn das Steuerelement angeklickt wird.

• Darstellung eines Wasserzeichens

• Anbindung an die Benutzerverwaltung zur Sperrung der Bedienbarkeit

• Darstellung des Hintergrunds, des Rahmens, des Schattens etc.

• Farbliche Darstellung des Hintergrunds, des Rahmens, des Textes etc., auch in Abhängigkeit vom Zustand des Steuerelements

Diese Funktionalitäten können Sie über die Eigenschaften im Fenster Eigenschaften konfigurieren, wenn Sie das Steuerelement im Designer oder in der Dokumentgliederung markieren. Ob eine Eigenschaft im Eigenschaftenfenster sichtbar ist, hängt vom Style des Steuerelements ab.

Aufbau

Das Steuerelement besteht aus einer Reihe weiterer Elemente. Sowohl das Steuerelement selbst als auch seine Elemente können über die Eigenschaften des Steuerelements konfiguriert werden. Eigenschaften für ein Unterelement des Steuerelements sind in der Regel in der Kategorie zu finden, die den Namen dieses Elements trägt.

Beispiel: Die Eigenschaften zur Konfiguration des Elements "Label" finden Sie im Fenster "Eigenschaften" in der Kategorie "Label", wenn Sie das Steuerelement im Designer oder in der Dokumentgliederung markieren.

Das TextVarIn und seine Elemente

Eingabefeld (Input, InputContainer, ...)

Das TextVarIn beinhaltet ein Eingabefeld (Input), in das zur Laufzeit ein Text eingegeben werden kann.

Wird der Style des TextVarIn zurückgesetzt, dann kann über Eigenschaften der Kategorie "Input" Folgendes konfiguriert werden:

• Art der Eingabe: Die Eigenschaft "InputType" legt fest, ob das Steuerelement zur Eingabe eines Texts (Text) oder eines Passworts (Password) verwendet werden soll.

• Breite und Höhe des Elements "InputContainer" (InputContainerWidth, InputContainerHeight)

• Breite und Höhe des Elements "Input" (InputWidth, InputHeight). Die Höhe wird automatisch auch für den übergeordneten "InputFieldContainer" übernommen.

• Äußere Abstände des Elements "InputField" (InputFieldMargin). Die Werte für links und rechts setzen dabei automatisch die inneren Abstände für das Element "Input".

  Mit dem Wert für Links der Eigenschaft "InputFieldMargin" können Sie die Eingabe weiter nach rechts verschieben.

  

  "InputFieldMargin" für links von 8 px (Standardeinstellung) und 24 px

• Rahmen um das Element "Input" (InputBorderRadius, InputBorderStyle, InputBorderWidth)

• Textschrift und Zeilenhöhe im Element "Input" (InputFontClass, InputTextContrast, InputFontSize, InputFontWeight, InputLineHeight)

Wie die Elemente strukturell zusammenhängen und welche Eigenschaften sich auf welches Element auswirken, zeigt die folgende Abbildung:

InputContainer und seine Elemente

Verwandte Themen:

• Layout