Hilfetext
Darstellung eines Textes als Hilfe oder Hinweis für die richtige Eingabe.
Der Hilfetext wird unterhalb des Eingabefelds eines Eingabesteuerelements angezeigt. Der Text kann als Konstante im Steuerelement definiert werden oder aus der Sprachumschaltung von »EASY UI Designer« bezogen werden.
Der Hilfetext wird in einer Hilfetextanzeige (Element "HelperText") dargestellt.
Das Element "HelperText" ist zum Beispiel im Steuerelement "NumericVarIn" enthalten.
Die Quelle, das Layout, die Darstellung, der Absatz und die Schrift des Hilfetextes können über die Eigenschaften der Kategorie "HelperText" des Steuerelements konfiguriert werden, die Farben des Hilfetextes über die Eigenschaften der Kategorie "Colors".
-
Standardmäßig wird der Hilfetext nicht angezeigt. Wenn Sie den Hilfetext im Steuerelement anzeigen wollen, aktivieren Sie die Eigenschaft "ShowHelperText".
Folgende Eigenschaften legen den Text selbst bzw. die Textquelle fest:
Verwenden Sie diese Eigenschaft, wenn der Text sprachunabhängig ist, z. B. ein Name oder eine Kurzbezeichnung.
Soll der Text 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 Eigenschaft "LocalizableHelperText" hat gegenüber der Eigenschaft "HelperText" Priorität.
Das Layout der Hilfetextanzeige kann über folgende Eigenschaften konfiguriert werden:
HelperTextHeight
Legt die Höhe der Hilfetextanzeige fest.
HelperTextMargin
Legt die äußeren Abstände der Hilfetextanzeige fest, d. h. zwischen dem Rand der Hilfetextanzeige und ihrem übergeordneten oder benachbarten Element.
HelperTextWidth
Legt die Breite der Hilfetextanzeige fest.
Für die Darstellung des Hilfetextes stehen folgende Eigenschaften zur Verfügung:
ShowHelperText
Legt fest, ob der Hilfetext angezeigt werden soll.
Die Textausrichtung und die Zeilenhöhe der Hilfetextanzeige werden über folgende Eigenschaften konfiguriert:
HelperTextAlignment
Legt die horizontale Ausrichtung des Hilfetextes innerhalb der Hilfetextanzeige fest. Siehe auch CSS-Referenz: text-align
HelperTextLineHeight
Legt die Höhe der Textzeile der Hilfetextanzeige fest. Siehe auch CSS-Referenz: line-height
-
Der Hilfetext wird einzeilig dargestellt. Überschüssiger Text wird durch eine Ellipse abgekürzt.
Die Schrift des Hilfetextes wird über folgende Eigenschaften konfiguriert:
HelperTextContrast
Legt fest, wie hell die Schrift des Hilfetextes dargestellt werden soll, von 1 (undurchsichtig, Standardeinstellung) über 0,5 (halb durchsichtig) bis 0 (komplett durchsichtig). Siehe auch CSS-Referenz: opacity
HelperTextFontClass
Legt die Schriftklasse des Hilfetextes 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.
HelperTextFontSize
Legt die Schriftgröße des Hilfetextes fest. Siehe auch CSS-Referenz: font-size
HelperTextFontWeight
Legt fest, wie dick oder dünn die Buchstaben des Hilfetextes dargestellt werden sollen. Siehe auch CSS-Referenz: font-weight
Verwandte Themen:
Betrifft diese Steuerelemente: