Color

Das Color Control zeigt Farben an und macht diese bei Bedarf einstellbar. Es enthält verschiedene Anzeigeelemente, um die Farbwerte zu repräsentieren, die abhängig von der Konfiguration auch zum Einstellen der Farbwerte verwendet werden können. Eine Übersicht über die Komponenten und den Aufbau finden Sie im Unterkapitel Anzeigeelemente. Die Beschreibung der einzelnen Konfigurationsmöglichkeiten finden Sie unter den folgenden Kategorien auf dieser Seite. Zu den jeweiligen Kategorien gibt es Unterkapitel mit weiteren Informationen, Details und Anwendungsbeispielen.

	Für alle folgenden Attribute besitzt das Control eine Getter- und eine Setter-Methode. Zum Beispiel existieren für das Attribut `Orientation` die beiden Methoden `getOrientation` und `setOrientation`. Die Benutzung der Attribute wird in den verlinkten Unterkapiteln näher erklärt. Alle weiteren Attribute, Events und Permissions die die Basisklasse Controls bereitstellt, finden Sie in der TwinCAT HMI Dokumentation.

Kategorie: Common

Die folgenden Attribute stellen eine Datenschnittstelle für den Farbwert des Controls dar. Es wird zum einen benutzt, um die angezeigte Farbe des Controls einzustellen, zum anderen um einen vom Nutzer eingegebenen Farbwert abzurufen.

Attribut	Typ	Beschreibung
`ColorSymbol`	ColorSymbol	HMI-Symbol, welches den aktuellen Farbwert enthält.
`ColorValue` _(readonly)	ColorValue	Farbwert. Dieser kann abgerufen werden, ohne dass ein Symbol als `ColorSymbol` verknüpft ist.

Funktion	Beschreibung
`setColorValue(colorValue:` ColorValue`): void`	Setzt den Farbwert. Kann aufgerufen werden, ohne dass ein Symbol als `ColorSymbol` verknüpft ist.

Kategorie: Appearance

Die folgenden Attribute bestimmen das Aussehen des Controls sowie den Umgang mit verschiedenen Farbformaten.

Attribut	Typ	Beschreibung
`ColorChannels`	ColorChannels	Definiert das Format der Farbe. Dies beinhaltet: Anzahl der Kanäle MinMax-Werte der Kanäle Integer oder Float Anzeige-Farben der Kanäle
`Orientation`	Orientation	Orientierung des Controls; analog zu der Orientierung der LinearGauge-Controls. „Horizontal“ oder „Vertical“.
`BoxUsage`	UsageMode	Bestimmt, ob die Farbbox angezeigt wird und ob sie bearbeitbar ist.
`ValuesUsage`	UsageMode	Bestimmt, ob die einzelnen Farbwerte angezeigt werden und ob sie bearbeitbar sind.
`SliderUsage`	UsageMode	Bestimmt, ob die einzelnen Farbwerte als Slider angezeigt werden und ob diese bearbeitbar sind.
`BoxColorConversion`	`Function`	Funktion, die den jeweiligen Farbwert in einen vom Browser interpretierbaren String konvertiert und umgekehrt. Dies ist nötig, um dem Control die Bedeutung der einzelnen Farbkanäle mitzuteilen, sofern diese vom Standardwert RGB-Format abweicht.
`BoxSize`	`Number (px)`	Bestimmt die Breite oder Höhe der Farbbox je nach Orientierung (Wert von Orientation).
`ValuesSize`	`Number (px)`	Bestimmt die Breite oder Höhe der angezeigten Farbwerte je nach Orientierung (Wert von Orientation).

Themed Resources

Mit folgenden Attributen kann das Aussehen von Unter-Controls (den Textboxen für die Farbwerte) unter den Themes Einstellungen verändert werden. Eine detaillierte Beschreibung der einzelnen Attribute ist in der Standard-HMI-Dokumentation zu finden.

Attribut	Typ
`TextFontFamily`	`FontFamily`
`TextFontSize`	`MeasurementValue`
`TextFontSizeUnit`	`MeasurementValue`
`TextFontStyle`	`FontStyle`
`TextFontWeight`	`FontWeight`
`TextPadding`	`Padding`

Weiterführende Informationen