Einheit
Darstellung einer Maßeinheit zusätzlich zum Variablenwert.
Bei einigen Steuerelementen, die einen Variablenwert anzeigen, kann auch die entsprechende Einheit (cm, kg, °C etc.) angezeigt werden. Die Einheit kann als Konstante im Steuerelement definiert werden, aus einer Textdefinition der Sprachumschaltung von »EASY UI Designer« oder aus der Variablendefinition der angebundenen Variablen bezogen werden. Im letzteren Fall muss die Variablendefinition einen Verweis auf eine Einheitenklasse beinhalten, welche die Einheitendefinition enthält, aus der der Einheitentext bezogen wird.
Die Einheit wird in einem Element "Unit" dargestellt.
Das Element "Unit" ist zum Beispiel im Steuerelement "NumericVarIn" enthalten.
Die Quelle, das Layout, die Darstellung, der Absatz und die Schrift der Einheit können über die Eigenschaften der Kategorie "Unit" des Steuerelements konfiguriert werden, die Farben der Einheit über die Eigenschaften der Kategorie "Colors".
Für grafische Ein- und Ausgabesteuerelemente (Bar, DonutGauge und Slider) kann zudem die Wertanzeige konfiguriert werden, die als Container für den Wert und die Einheit fungiert.
Folgende Eigenschaften legen den Einheitentext selbst bzw. die Quelle des Einheitentextes fest:
UnitText
Verwenden Sie diese Eigenschaft, wenn die Einheit sprachunabhängig, d. h. für alle Projektsprachen gültig, ist.
LocalizableUnitText
Soll die Einheit 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 "LocalizableUnitText" hat gegenüber der Eigenschaft "UnitText" Priorität.
UseVariableUnitText
Legt fest, dass die Einheit aus der Einheitenklasse verwendet wird, die in der Variablendefinition im Parameter Einheitenklasse (Anzeige) angegeben ist.
-
Die Eigenschaft "UseVariableUnitText" hat gegenüber den Eigenschaften "LocalizableUnitText" und "UnitText" Priorität. Ist also die Eigenschaft "UseVariableUnitText" aktiviert, dann stellen Sie sicher, dass die Variablendefinition einen Verweis auf eine Einheitenklasse enthält.
Verwenden Sie nur eine der Eigenschaften für die Textquelle, damit diese für Sie eindeutig erkennbar ist.
Das Layout der Einheitenanzeige kann über folgende Eigenschaften konfiguriert werden:
UnitHeight
Legt die Höhe der Einheitenanzeige fest.
UnitMargin
Legt die äußeren Abstände der Einheitenanzeige fest, d. h. zwischen dem Rand der Einheitenanzeige und ihrem übergeordneten oder benachbarten Element.
UnitPadding
Legt die inneren Abstände der Einheitenanzeige fest, d. h. zwischen dem Rand der Einheitenanzeige und ihrem Inhalt, also dem Einheitentext.
UnitWidth
Legt die Breite der Einheitenanzeige fest.
Für die Darstellung der Einheit stehen folgende Eigenschaften zur Verfügung:
ShowUnit
Legt fest, ob die Einheit angezeigt werden soll.
Die Zeilenhöhe und die Textausrichtung der Einheitenanzeige werden über folgende Eigenschaften konfiguriert:
UnitLineHeight
Legt die Höhe der Textzeile für die Einheit fest. Siehe auch CSS-Referenz: line-height
UnitTextAlignment
Legt die horizontale Ausrichtung des Einheitentextes in der Einheitenanzeige fest. Siehe auch CSS-Referenz: text-align
Die Schrift der Einheit wird über folgende Eigenschaften konfiguriert:
UnitFontClass
Legt die Schriftklasse der Einheit 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.
UnitFontSize
Legt die Schriftgröße der Einheit fest. Siehe auch CSS-Referenz: font-size
UnitFontWeight
Legt fest, wie dick oder dünn die Zeichen der Einheit dargestellt werden sollen. Siehe auch CSS-Referenz: font-weight
UnitTextContrast
Legt fest, wie hell die Schrift der Einheit dargestellt werden soll, von 1 (undurchsichtig, Standardeinstellung) über 0,5 (halb durchsichtig) bis 0 (komplett durchsichtig). Siehe auch CSS-Referenz: opacity
Verwandte Themen:
Betrifft diese Steuerelemente:
Bar, DonutGauge, NumericVarIn, NumericVarOut, PieSegment, Slider, StackedDonutGaugeSegment