GETCOLORRANGE
Deze functie retourneert de RGBA-waarden van meerdere kleuren als een matrix, of de waarde van één kleur. Deze functie wordt gebruikt om kleuren uit het Application Studio-kleurenpalet door te geven aan web-extensies.
Het kleurenpalet bevat 64 kleuren in een raster van 8 rijen en 8 kolommen. Elke kleur in het palet wordt geïdentificeerd door middel van een indexnummer van 1 tot 64. De indexnummers nemen toe van boven naar beneden en van links naar rechts in het raster.
U kunt de volgende kleurbereiken opgeven:
- Een individuele kleur
- Een eendimensionale matrix
Bijvoorbeeld de 34ste en de 49ste kleur in het raster
- Een tweedimensionale matrix
Bijvoorbeeld een blok van vier rijen met drie kleuren in elke rij
Syntaxis
GETCOLORRANGE(initiële_index,aantal_kleuren_per_rij,aantal_rijen)
Voorbeeld - één kleur
Als u één kleur opgeeft, is de parameter count_of_rows optioneel, maar wordt standaard ingesteld als 1. De volgende voorbeelden retourneren dezelfde kleur:
=GETCOLORRANGE(2,1)
=GETCOLORRANGE(2,1,1)
De volgende voorbeelden retourneren hetzelfde resultaat als dit voorbeeld van de functie GETCOLOR:
=GETCOLOR(2).
Voorbeeld - eendimensionale matrix
Het volgende voorbeeld retourneert een matrix met zestien kleurwaarden. De eerste kleur is de 34ste in het raster en de zestiende kleur is de 49ste kleur:
=GETCOLORRANGE(34,l6)
Voorbeeld - tweedimensionale matrix
Het volgende voorbeeld retourneert een matrix met twaalf kleuren. De matrix bevat vier rijen met elk drie kleuren. De eerste kleur is de 5de in het raster en de twaalfde kleur is de 31ste. Dit houdt in dat de functie de drie kleuren rechts van de vijfde kleur in het raster opgeeft, en vier rijen omlaag vanaf de bovenkant:
=GETCOLORRANGE(5,3,4)