Farben
Standardfarben und statusabhängige Farben für den Hintergrund, den Text und andere Bestandteile eines Steuerelements.
Die in einem Steuerelement verwendeten Farben sind für alle Steuerelemente bereits voreingestellt, sodass eine einheitliche farbliche Gestaltung über die gesamte Applikation gewährleistet ist. Zudem können die voreingestellten Farben je nach gewähltem Theme per Knopfdruck umgeschaltet werden. Sollen im Steuerelement dennoch andere Farben verwendet werden, dann können diese über die Eigenschaften in der Kategorie "Colors" individuell für das Steuerelement festgelegt werden.
Die Kategorie "Colors" enthält eine ganze Reihe von Eigenschaften, die hier nicht einzeln aufgeführt und erläutert werden. Welche Bedeutung die jeweilige Eigenschaft hat, lässt sich aus dem Namen der Eigenschaft erschließen, wenn die Bedeutungen der wichtigsten Eigenschaften für Farben bekannt sind.
Diese wichtigsten Eigenschaften sind:
Legt die Farbe für den Hintergrund fest.
Legt die Farbe für den Rahmen fest.
Legt die Farbe für den Text, die Icons (siehe Kapitel Grafiken) oder die Beschriftung fest.
Farben für einen Zustand
Für die Visualisierung eines besonderen Zustands des Steuerelements, z. B. wenn das Steuerelement vom Bediener aktiviert wurde und an ist (Zustand "Checked"), können Farben über entsprechende Eigenschaften festgelegt werden. Die Eigenschaften, welche die Farben für die möglichen Zustände des Steuerelements festlegen, beinhalten den Namen des Zustands im Eigenschaftsnamen.
Beispiel: CheckedBackgroundColor
Legt die Farbe für den Hintergrund des ToggleButtons fest, wenn sich dieser im Zustand "Checked" befindet, d. h. an ist.
Farben für ein Unterelement
Eigenschaften, welche die Farbe für ein Unterelement des Steuerelements festlegen, beinhalten den Namen dieses Unterelements im Eigenschaftsnamen.
Beispiel: Im Steuerelement DropDownBox z. B. steht die Eigenschaft "InputForegroundColor" zur Verfügung, welche die Textfarbe für das Unterelement Input definiert.
Beispiel: Die Eigenschaft "UnderlineColor" legt die Farbe für den Unterstrich fest, der in den Steuerelementen NumericVarIn und TextVarIn im Style "Plain.Default" zur Verfügung steht.
Weitere Farben
Weitere Farben, die in einigen Steuerelementen zur Verfügung stehen, sind:
CaretColor
Legt die Farbe für die Eingabemarke des Eingabesteuerelements fest.
Legt die Farbe fest, die im Falle eines Fehlers, z. B. wenn der Grenzwert überschritten wird, im Steuerelement für den Fehlertext, das Fehlersymbol und den Rahmen des Eingabefelds verwendet wird.
Legt die Farbe für ein Listenelement (StateIndicatorItem) in einem StateIndicator, einen Wertebereich (ColorIndicatorLimit) in einem ColorIndicator, ein Segment (PieSegment, StackedDonutGaugeSegment) in einem PieChart oder in einem StackedDonutGauge fest.
Farbkategorien
In jeder Eigenschaft in der Kategorie "Colors" stehen folgende Arten von Farben zur Verfügung:
Theme-Farben sind Schlüsselwörter, die je nach Theme eine andere Farbe beinhalten. Das @-Zeichen vor dem Schlüsselwort gibt an, dass es sich um eine Theme-Farbe handelt. Standardmäßig beinhalten alle Steuerelemente Theme-Farben.
Custom
Benutzerdefinierte Liste von Farben. Diese Farben sind nicht Theme-abhängig. Die Farbwerte sind in der Datei customcolors.json im Ordner resourcesWcolors festgelegt.
ColorPalette
Umfangreiche Farbpalette für Web. Diese Farben sind nicht Theme-abhängig. Die Farbwerte sind in der Datei colorpalette.json im Ordner resourcesWcolors festgelegt.