Beschriftung

Darstellung eines Beschriftungstextes zusätzlich zum Variablenwert.

Die Beschriftung ist ein Text, der zusätzlich zu einer grafischen Darstellung (z. B. Häkchen, grafischer Schiebeschalter) des Steuerelementes angezeigt wird. Der Text kann als Konstante im Steuerelement definiert werden oder aus einer Textdefinition des EASY UI Designer Systemmoduls Sprachumschaltung bezogen werden. Unterstützt das Steuerelement auch die Anbindung an eine Prozessvariable, so kann der Text alternativ aus der angebundenen Variablendefinition des Systemmoduls Variablen bezogen werden. Auch dieser Text ist dann sprachumschaltbar.

Die Beschriftung wird in einem Element "Label" dargestellt.

Das Element "Label" ist zum Beispiel im Steuerelement "NumericVarIn" enthalten.

Die Quelle, das Layout, die Darstellung, der Absatz und die Schrift der Beschriftung können über die Eigenschaften der Kategorie "Label" des Steuerelements konfiguriert werden, die Farben der Beschriftung über die Eigenschaften der Kategorie "Colors".

Einige Steuerelemente zeigen in den System-Styles der Style-Familien "Plain" und "Material" statt einer normalen Beschriftung oberhalb des Eingabefelds (Label) eine schwebende Beschriftung innerhalb des Eingabefelds (FloatingLabel) an. Schwebend heißt diese Beschriftung deshalb, weil sie über der eigentlichen Eingabe schwebt. Ist das Eingabefeld leer und das Steuerelement befindet sich nicht im Zustand "Focused", dann wird das "FloatingLabel" anstelle der Eingabe angezeigt.

FloatingLabel beim NumericVarIn (Plain.Default)

Ist eine schwebende Beschriftung für ein Steuerelement vorgesehen, dann können die Quelle, das Layout, die Darstellung und die Schrift der schwebenden Beschriftung über die Eigenschaften der Kategorie "FloatingLabel" des Steuerelements festgelegt werden können.

Die Eigenschaftsnamen für das FloatingLabel lehnen sich an die Namen der Eigenschaften für das Label an und haben die gleiche Bedeutung.

Beispiel: Wie die Eigenschaft "LocalizableLabelText" den sprachumschaltbaren Text für das Element "Label" festlegt, so legt die Eigenschaft "LocalizableFloatingLabelText" den sprachumschaltbaren Text für das Element "FloatingLabel" fest.

Die Farben der schwebenden Beschriftung werden über die Eigenschaften der Kategorie "Colors" des Steuerelements festgelegt.

Folgende Eigenschaften legen den Beschriftungstext bzw. die Quelle des Beschriftungstextes fest:

LabelText (LabelTextOff/LabelTextOn)

Verwenden Sie diese Eigenschaft, wenn die Beschriftung sprachunabhängig ist, z. B. ein Name oder eine Kurzbezeichnung.

Einige Steuerelemente mit Variablenanbindung können abhängig vom Variablenwert unterschiedliche Texte darstellen. Ist der Wert der Variable false, wird der Text der Eigenschaft "LabelTextOff" angezeigt, bei dem Wert true der Text der Eigenschaft " LabelTextOn".

LocalizableLabelText (LocalizableLabelTextOff/LocalizableLabelTextOn)

Soll die Beschriftung sprachabhängig sein, kann hier über die Schaltfläche der Textauswahldialog geöffnet werden. Hierdurch wird die Verbindung zu einer EASY UI Designer Textdefinition hergestellt. Die Eigenschaft speichert dann den vollständigen Namen der Textdefinition.

Die Anmerkung für " LabelTextOff/LabelTextOn" gilt entsprechend für "LocalizableLabelTextOff/LocalizableLabelTextOn".

UseVariableText

Unterstützt das Steuerelement die Anbindung an eine Prozessvariable, steht diese Eigenschaft zur Verfügung. Ist die Option aktiviert, so wird die Beschriftung aus dem Parameter Text der Variablendefinition bezogen.

Verwenden Sie nur eine der Eigenschaften für die Textquelle, damit diese für Sie eindeutig erkennbar ist.

Das Layout der Beschriftung kann über folgende Eigenschaften konfiguriert werden:

LabelContainerHeight

Legt die Höhe des Containers fest, der das Symbol und die Beschriftung enthält.

LabelContainerWidth

Legt die Breite des Containers fest, der das Symbol und die Beschriftung enthält.

LabelHeight

Legt die Höhe der Beschriftung fest.

LabelMargin

Legt die äußeren Abstände der Beschriftung fest, d. h. zwischen dem Rand der Beschriftung und seinem übergeordneten oder benachbarten Element.

LabelPadding

Legt die inneren Abstände der Beschriftung fest, d. h. zwischen dem Rand der Beschriftung und seinem Inhalt, also dem eigentlichen Beschriftungstext.

LabelPosition

Legt die Position der Beschriftung innerhalb des Steuerelements fest.

Bei einigen Steuerelementen stehen nur zwei Einstellungen zur Verfügung, z. B. "Left" und "Right" bei der Checkbox.
Left

Die Beschriftung wird links im Steuerelement positioniert.
Top

Die Beschriftung wird oben im Steuerelement positioniert.
Bottom

Die Beschriftung wird unten im Steuerelement positioniert.
Right

Die Beschriftung wird rechts im Steuerelement positioniert.

LabelWidth

Legt die Breite der Beschriftung fest.

Für die Darstellung der Beschriftung stehen folgende Eigenschaften zur Verfügung:

LabelContainerBorderRadius

Legt die Stärke der Rundung der Ecken für den Rahmen des Containers fest, der das Symbol und die Beschriftung enthält.

LabelContainerBorderStyle

Legt die Art des Rahmens des Containers fest, der das Symbol und die Beschriftung enthält.

LabelContainerBorderWidth

Legt die Dicke der Rahmenlinie des Containers fest, der das Symbol und die Beschriftung enthält.

ShowLabel

Legt fest, ob die Beschriftung angezeigt werden soll.

Die Zeilenhöhe und die Textausrichtung der Beschriftung werden über folgende Eigenschaften konfiguriert:

LabelLineHeight

Legt die Höhe der Textzeile der Beschriftung fest. Siehe auch CSS-Referenz: line-height

LabelTextAlignment

Legt die horizontale Ausrichtung des Beschriftungstextes innerhalb der Beschriftung fest. Siehe auch CSS-Referenz: text-align

Die Schrift des Beschriftungstextes wird über folgende Eigenschaften konfiguriert:

LabelFontClass

Legt die Schriftklasse des Beschriftungstextes fest.

Die Eigenschaft enthält eine Liste von Schriftklassen, aus denen eine ausgewählt werden kann. Die Einstellungen werden aus einer CSS-Datei bezogen (fontclasses.css), die im Ordner resourcesWtypography im Client-Projektverzeichnis zu finden ist.

LabelFontSize

Legt die Schriftgröße des Beschriftungstextes fest. Siehe auch CSS-Referenz: font-size

LabelFontWeight

Legt fest, wie dick oder dünn die Buchstaben des Beschriftungstextes dargestellt werden sollen. Siehe auch CSS-Referenz: font-weight

LabelTextContrast

Legt fest, wie hell der Beschriftungstext dargestellt werden soll, von 1 (undurchsichtig, Standardeinstellung) über 0,5 (halb durchsichtig) bis 0 (komplett durchsichtig). Siehe auch CSS-Referenz: opacity.

LabelUppercase

Legt fest, ob der Beschriftungstext in Großbuchstaben dargestellt wird. Siehe auch CSS-Referenz: text-transform

Verwandte Themen:

Das Systemmodul Sprachumschaltung

Betrifft diese Steuerelemente:

Checkbox, DateTimeVarIn, DateTimeVarOut, DropDownBox, NumericVarIn, NumericVarOut, PieSegment, RadioButton, SelectBox, StackedDonutGaugeSegment, Switch, TextVarIn, TextVarOut