GETCOLORRANGE
Diese Funktion gibt die RGBA-Werte mehrerer Farben als Array oder den Wert einer einzelnen Farbe zurück. Die Funktion wird verwendet, um Farben aus der Application Studio-Farbpalette an Weberweiterungen weiterzuleiten.
Die Farbpalette enthält 64 Farben in einem Raster aus acht Zeilen und acht Spalten. Jede Farbe in der Palette wird durch eine Indexzahl zwischen 1 und 64 identifiziert. Die Indexzahlen steigen auf dem Raster von oben nach unten und von links nach rechts.
Sie können die folgenden Farbbereiche angeben:
- Eine einzelne Farbe
- Ein eindimensionales Array
Zum Beispiel die 34. und die 49. Farbe im Raster
- Ein zweidimensionales Array
Zum Beispiel ein Block von vier Reihen mit drei Farben in jeder Reihe
Syntax
GETCOLORRANGE(initial_index,count_of_colors_per_row,count_of_rows)
Beispiel – einzelne Farbe
Wenn Sie eine einzelne Farbe angeben, ist der Parameter count_of_rows optional und standardmäßig auf 1 gestellt. Die folgenden Beispiele geben die gleiche einzelne Farbe zurück:
=GETCOLORRANGE(2,1)
=GETCOLORRANGE(2,1,1)
Die folgenden Beispiele geben das gleiche Ergebnis wie das folgende Beispiel der GETCOLOR-Funktion zurück:
=GETCOLOR(2).
Beispiel – eindimensionales Array
Das folgende Beispiel gibt ein Array aus sechzehn Farbwerten zurück. Die erste Farbe ist die 34. im Raster, und die sechzehnte Farbe ist die 49. im Raster:
=GETCOLORRANGE(34,l6)
Beispiel – zweidimensionales Array
Das folgende Beispiel gibt ein Array aus zwölf Farbwerten zurück. Das Array enthält vier Zeilen mit jeweils drei Farben. Die erste Farbe ist die fünfte im Raster und die zwölfte die 31. Das bedeutet, die Funktion gibt die drei Farben rechts der fünften Farbe im Raster an sowie vier Zeilen unterhalb der Oberseite:
=GETCOLORRANGE(5,3,4)