Farbdaten
Das Attribut ColorSymbol kann an verschiedene Symbole gebunden werden. Um Unstimmigkeiten zwischen dem ausgegebenen Farbwert und dem Datentyp des Symbols zu vermeiden, liest das Color-Control den Typ des Symbols und versucht, automatisch den richtigen Rückgabetyp abzuleiten.
Wenn zum Beispiel drei Farbkanäle angezeigt werden sollen, in der SPS jedoch ein Array vom Typ TcVnVector4_LREAL verknüpft wird, stimmen diese Typen nicht überein. Dies erkennt das Color Control automatisch und schreibt ein Array mit vier anstatt mit drei Werten in das Symbol, sodass kein Fehler auftritt. Der übrige Kanal wird dabei leer gelassen.
Das schreibgeschützte Attribut ColorValue dient dazu, die Farbe programmatisch zugänglich zu machen, ohne ein Symbol an die Eigenschaft ColorSymbol binden zu müssen. Ansonsten gibt es keinen Unterschied. Eine gleichzeitige Nutzung beider Varianten ist möglich. Hierbei ist zu beachten, dass ColorValue ebenfalls den Datentypen des Symbols ausgibt, welches an ColorSymbol gebunden ist.
Mit dem Attribut SliderValueUpdate wird festgelegt, ob das Farbsymbol, während onChanged oder am Ende onConfirmed einer Interaktion mit den Slidern aktualisiert werden soll. Wenn der Farbwert während einer Sliderbewegung (onChanged) geändert wird und ein Symbol an das Attribut ColorSymbol gebunden ist, kann es vorkommen, dass der Wert nach dem Loslassen des Sliders auf einen älteren Wert zurückspringt. Wenn dies Verhalten nicht gewünscht ist, sollte SliderValueUpdate auf onConfirmed gesetzt werden.
In Analogie zur Eigenschaft ColorValue bietet die Methode SetColorValue eine Möglichkeit, die Farbwerte dieses Controls einzustellen, ohne ein Symbol mit der Eigenschaft ColorSymbol zu verknüpfen.
Die beiden Zugriffsarten auf den Farbwert sind anhand der folgenden Beispiele erläutert:
Wie die Farbdaten auch für andere Anwendungsfälle verwendet werden können zeigt das Beispiel Konvertierung zu HMI-Farbobjekt.