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.
`ColorChannels`	ColorChannels	Definiert das Format der Farbe. Dies beinhaltet: Anzahl der Kanäle Min-/Max-Werte der Kanäle Integer oder Float Anzeige-Farben der Kanäle
`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.
`ColorValue` _(readonly)	ColorValue	Farbwert. Dieser kann abgerufen werden, ohne dass ein Symbol als `ColorSymbol` verknüpft ist.

Das Attribut ColorValue passt sich immer an den Datentype der gemappten SPS-Variable an. Standard ist ein 4 kanaliges Array (TcVnVector4_LREAL) was auch ohne ein Mapping verwendet wird. Weitere mögliche SPS-Datentypen sind INT, REAL, TcVnVector3_LREAL.

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

Kategorie: Usage

Die folgenden Attribute legen das Verhalten des Controls fest.

Attribut	Typ	Beschreibung
`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.
`SliderValueUpdate`	`DataUpdate`	Legt fest, ob das Farbsymbol, während `onChanged` oder am Ende `onConfirmed` einer Interaktion mit den Slidern aktualisiert werden soll.

Kategorie: Appearance

Die folgenden Attribute bestimmen das Aussehen des Controls.

Attribut	Typ	Beschreibung
`Orientation`	Orientation	Orientierung des Controls; analog zu der Orientierung der LinearGauge-Controls. `Horizontal` oder `Vertical`.
`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