Der Befehl OBJECT GET RGB COLORS gibt die Vorder- und Hintergrundfarbe des Objekts bzw. der Objektgruppe zurück, definiert in Objekt.
Mit dem optionalen Parameter * geben Sie an, dass der Parameter Objekt ein Objektname ist (String). Ohne diesen Parameter geben Sie an, dass Objekt ein Feld oder eine Variable ist. In diesem Fall übergeben Sie eine Feld- oder eine Variablenreferenz (nur Objektfeld oder -variable) anstelle eines String.
Ein gültiger backgroundColor-Wert wird nur für Unterstützung der Hintergrundfarbe durch Objekte zurückgegeben.
Wird der Befehl auf ein Objekt vom Typ Listbox angewandt, kann die wechselnde Hintergrundfarbe der Zeilen im Parameter altHintergrFarbe zurückgegeben werden. In diesem Fall wird der Wert von Hintergrundfarbe nur für den Hintergrund der Zeilen mit ungerader Nummer verwendet.
Die RGB Farbwerte, die in den Parametern Vordergrundfarbe, Hintergrundfarbe und altHintergrFarbe zurückgegeben werden, richten sich nach dem Parametertyp:
- bei einem Parameter vom Typ Text wird die Farbe im CSS Format mit der Syntax "#rrggbb" zurückgegeben, z.B. 0000FF
- bei einem Parameter vom Typ Lange Ganzzahl kann die Farbe eine 4-Byte Lange Ganzzahl im Format 0x00RRGGGBB sein oder eine negativer Wert, der den Farben des Systems entspricht
Weitere Informationen über das Format der Parameter Vordergrundfarbe, Hintergrundfarbe und altHintergrFarbe finden Sie unter dem Befehl OBJECT SET RGB COLORS.