GETCOLORRANGE

Funkcja zwraca wartości RGBA wielu kolorów jako tablicę, lub wartość pojedynczego koloru. Funkcja ta jest wykorzystywana do przekazywania kolorów z palety kolorów Application Studio do rozszerzeń sieci web.

Paleta kolorów zawiera 64 kolory w siatce 8 wierszy i 8 kolumn. Każdy kolor w palecie jest określany przy pomocy numeru indeksu od 1 do 64. Numery indeksu w siatce wzrastają od góry do dołu i od lewej do prawej.

Możesz określić następujące zakresy kolorów:

  • Pojedynczy kolor
  • Tablicę jednowymiarową

    Na przykład 34. i 49. kolor z siatki.

  • Tablicę dwuwymiarową

    Na przykład blok czterech wierszy po trzy kolory w każdym wierszu

Składnia

GETCOLORRANGE(indeks_początkowy,liczba_kolorów_w_wierszu,liczba_wierszy)

Przykład – pojedynczy kolor

Podczas określania pojedynczego koloru parametr count_of_rows jest nieobowiązkowy, ale domyślnie wynosi wówczas 1. W tych przykładach zwracany jest ten sam pojedynczy kolor:

=GETCOLORRANGE(2,1)

=GETCOLORRANGE(2,1,1)

Uwaga

W tych przykładach zwracany jest ten wynik, co w następującym przykładzie funkcji GETCOLOR:

=GETCOLOR(2).

Przykład – tablica jednowymiarowa

W tym przykładzie zwrócona zostanie tablica szesnastu wartości kolorów. Pierwszy kolor jest 34. w siatce a szesnasty kolor jest 49. kolorem w siatce:

=GETCOLORRANGE(34,l6)

Przykład – tablica dwuwymiarowa

W tym przykładzie zwrócona zostanie tablica dwunastu wartości kolorów. Tablica zawiera cztery wiersze po trzy kolory każdy. Pierwszy kolor jest piąty w siatce a dwunasty kolor jest trzydziesty pierwszy. Oznacza to, że funkcja określa trzy kolory po prawej stronie piątego koloru w siatce i cztery wiersze w dół od góry:

=GETCOLORRANGE(5,3,4)