GETCOLORRANGE
Retorna os valores RGBA de várias cores como uma matriz ou um valor de uma cor única. A função é usada para passar cores de uma paleta de cores do Application Studio para extensões da Web.
A paleta de cores contém 64 cores em uma grade de 8 linhas e 8 colunas. Cada cor na paleta é identificada por um número de índice de 1 a 64. Os números de índice são incrementados de cima para baixo e da esquerda para a direita da grade.
Você pode especificar estes intervalos de cores:
- Uma cor individual
- Matriz unidimensional
Por exemplo, a 34ª e a 49ª cor na grade
- Matriz bidimensional
Por exemplo, um bloco de quatro linhas com três cores em cada linha
Sintaxe
GETCOLORRANGE(indice_inicial_,countagem_de_cores_por_linha,contagem_de_linhas)
Exemplo - cor única
Quando você especificar somente uma cor, o parâmetro count_of_rows será opcional, mas o padrão é 1. Estes exemplos retornam a mesma cor única:
=GETCOLORRANGE(2,1)
=GETCOLORRANGE(2,1,1)
Estes exemplos retornam o mesmo resultado como este exemplo da função GETCOLOR:
=GETCOLOR(2).
Exemplo - matriz unidimensional
Este exemplo retorna uma matriz de dezesseis valores de cor. A primeira cor é a 34ª na grade e a 16ª cor é a 49ª cor na grade:
=GETCOLORRANGE(34,l6)
Exemplo - matriz bidimensional
Esse exemplo retorna uma matriz de doze cores. A matriz contém quatro linhas de três cores cada. A primeira cor é a 5ª na grade e a 12ª cor é a 31ª: Isto é, a função especifica as três cores da direita, dentre as cinco cores da grade, e quatro linhas abaixo da parte superior:
=GETCOLORRANGE(5,3,4)