Fehlertext
Darstellung eines Textes im Steuerelement im Falle eines Fehlers.
Der Fehlertext wird unterhalb des Eingabefelds eines Eingabesteuerelements angezeigt, wenn die Benutzereingabe die festgelegten Grenzen überschreitet. Der Text kann als Konstante im Steuerelement definiert werden oder aus der Sprachumschaltung von EASY UI Designer bezogen werden.
Der Fehlertext wird in einer Fehlertextanzeige (Element "ErrorText") dargestellt.
Das Element "ErrorText" ist zum Beispiel im Steuerelement "NumericVarIn" enthalten.
Die Quelle, das Layout, die Darstellung, der Absatz und die Schrift des Fehlertextes können über die Eigenschaften der Kategorie "ErrorText" des Steuerelements konfiguriert werden, die Farben des Fehlertextes über die Eigenschaften der Kategorie "Colors".
-
Standardmäßig wird der Fehlertext nicht angezeigt. Wenn Sie den Fehlertext im Steuerelement anzeigen wollen, aktivieren Sie die Eigenschaft "ShowErrorText".
Folgende Eigenschaften legen den Text selbst bzw. die Textquelle fest:
LimitMaxErrorText/LimitMinErrorText
Überschreitet die Eingabe den in der Eigenschaft "RawLimitMax" festgelegten Grenzwert, dann wird der in der Eigenschaft "LimitMaxErrorText" angegebene Text im Steuerelement angezeigt. Entsprechend wird der in der Eigenschaft "LimitMinErrorText" angegebene Text im Falle der Unterschreitung des unteren Grenzwertes (RawLimitMin) angezeigt. Verwenden sie diese Eigenschaften, wenn die Fehlertexte sprachunabhängig sind.
LocalizableLimitMaxErrorText/LocalizableLimitMinErrorText
Sollen die Fehlertexte 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 Eigenschaften "LocalizableLimitMaxErrorText"/"LocalizableLimitMinErrorText2 haben gegenüber den Eigenschaften "LimitMaxErrorText"/"LimitMinErrorText" Priorität.
Das Layout der Fehlertextanzeige kann über folgende Eigenschaften konfiguriert werden:
ErrorTextHeight
Legt die Höhe der Fehlertextanzeige fest.
ErrorTextMargin
Legt die äußeren Abstände der Fehlertextanzeige fest, d. h. zwischen dem Rand der Fehlertextanzeige und ihrem übergeordneten oder benachbarten Element.
ErrorTextWidth
Legt die Breite der Fehlertextanzeige fest.
Für die Darstellung des Fehlertextes stehen folgende Eigenschaften zur Verfügung:
ShowErrorText
Legt fest, ob der Fehlertext angezeigt werden soll.
Die Textausrichtung und die Zeilenhöhe der Fehlertextanzeige werden über folgende Eigenschaften konfiguriert:
ErrorTextAlignment
Legt die horizontale Ausrichtung des Fehlertextes innerhalb der Fehlertextanzeige fest. Siehe auch CSS-Referenz: text-align
ErrorTextLineHeight
Legt die Höhe der Textzeile der Fehlertextanzeige fest. Siehe auch CSS-Referenz: line-height
Die Schrift des Fehlertextes wird über folgende Eigenschaften konfiguriert:
ErrorTextContrast
Legt fest, wie hell die Schrift des Fehlertextes dargestellt werden soll, von 1 (undurchsichtig, Standardeinstellung) über 0,5 (halb durchsichtig) bis 0 (komplett durchsichtig). Siehe auch CSS-Referenz: opacity
ErrorTextFontClass
Legt die Schriftklasse des Fehlertextes 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.
ErrorTextFontSize
Legt die Schriftgröße des Fehlertextes fest. Siehe auch CSS-Referenz: font-size
ErrorTextFontWeight
Legt fest, wie dick oder dünn die Buchstaben des Fehlertextes dargestellt werden sollen. Siehe auch CSS-Referenz: font-weight
Verwandte Themen:
Betrifft diese Steuerelemente: