Esta página foi traduzida pela API Cloud Translation.

Class Banding

Acesse e modifique faixas, os padrões de cores aplicados a linhas ou colunas de um intervalo. Cada faixa consiste em um intervalo e um conjunto de cores para linhas, colunas, cabeçalhos e rodapés.

Métodos

Método	Tipo de retorno	Breve descrição
`copyTo(range)`	`Banding`	Copia a banda para outro intervalo.
`getFirstColumnColorObject()`	`Color`	Retorna a primeira cor alternada da coluna nas faixas ou `null` se nenhuma cor estiver definida.
`getFirstRowColorObject()`	`Color`	Retorna a primeira cor alternada da linha ou `null` se nenhuma cor for definida.
`getFooterColumnColorObject()`	`Color`	Retorna a cor da última coluna no banding, ou `null` se nenhuma cor for definida.
`getFooterRowColorObject()`	`Color`	Retorna a cor da última linha na faixa ou `null` se nenhuma cor for definida.
`getHeaderColumnColorObject()`	`Color`	Retorna a cor da primeira coluna no banding, ou `null` se nenhuma cor for definida.
`getHeaderRowColorObject()`	`Color`	Retorna a cor da linha do cabeçalho ou `null` se nenhuma cor for definida.
`getRange()`	`Range`	Retorna o intervalo da banda.
`getSecondColumnColorObject()`	`Color`	Retorna a segunda cor alternada da coluna na banda ou `null` se nenhuma cor for definida.
`getSecondRowColorObject()`	`Color`	Retorna a segunda cor alternada da linha ou `null` se nenhuma cor for definida.
`remove()`	`void`	Remove essa faixa.
`setFirstColumnColor(color)`	`Banding`	Define a cor da primeira coluna alternada.
`setFirstColumnColorObject(color)`	`Banding`	Define a primeira cor alternada da coluna nas faixas.
`setFirstRowColor(color)`	`Banding`	Define a cor da primeira linha alternada.
`setFirstRowColorObject(color)`	`Banding`	Define a primeira cor alternada da linha na faixa.
`setFooterColumnColor(color)`	`Banding`	Define a cor da última coluna.
`setFooterColumnColorObject(color)`	`Banding`	Define a cor da última coluna no banding.
`setFooterRowColor(color)`	`Banding`	Define a cor da última linha.
`setFooterRowColorObject(color)`	`Banding`	Define a cor da linha do rodapé na banda.
`setHeaderColumnColor(color)`	`Banding`	Define a cor da coluna de cabeçalho.
`setHeaderColumnColorObject(color)`	`Banding`	Define a cor da coluna de cabeçalho.
`setHeaderRowColor(color)`	`Banding`	Define a cor da linha do cabeçalho.
`setHeaderRowColorObject(color)`	`Banding`	Define a cor da linha do cabeçalho.
`setRange(range)`	`Banding`	Define o intervalo para estas faixas.
`setSecondColumnColor(color)`	`Banding`	Define a cor da segunda coluna alternada.
`setSecondColumnColorObject(color)`	`Banding`	Define a segunda cor alternada da coluna nas faixas.
`setSecondRowColor(color)`	`Banding`	Define a cor da segunda linha alternada.
`setSecondRowColorObject(color)`	`Banding`	Define a segunda cor alternada na banda.

Métodos obsoletos

Método	Tipo de retorno	Breve descrição
`getFirstColumnColor()`	`String`	Retorna a cor da primeira coluna alternada ou `null` se nenhuma cor for definida.
`getFirstRowColor()`	`String`	Retorna a cor da primeira linha alternada ou `null` se nenhuma cor estiver definida.
`getFooterColumnColor()`	`String`	Retorna a cor da última coluna, ou `null` se nenhuma cor for definida.
`getFooterRowColor()`	`String`	Retorna a cor da última linha, ou `null` se nenhuma cor estiver definida.
`getHeaderColumnColor()`	`String`	Retorna a cor da coluna de cabeçalho ou `null` se nenhuma cor for definida.
`getHeaderRowColor()`	`String`	Retorna a cor da linha do cabeçalho ou `null` se nenhuma cor for definida.
`getSecondColumnColor()`	`String`	Retorna a segunda cor da coluna alternada ou `null` se nenhuma cor for definida.
`getSecondRowColor()`	`String`	Retorna a cor da segunda linha alternada ou `null` se nenhuma cor estiver definida.

Documentação detalhada

`copyTo(range)`

Copia a banda para outro intervalo.

Parâmetros

Nome	Tipo	Descrição
`range`	`Range`	O intervalo em que a banda será copiada.

Retornar

Banding: a nova banda.

Autorização

Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`getFirstColumnColorObject()`

Retorna a primeira cor alternada da coluna nas faixas ou null se nenhuma cor estiver definida.

Retornar

Color: a primeira cor de coluna alternativa na faixa, ou null se nenhuma cor for definida.

Autorização

Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`getFirstRowColorObject()`

Retorna a primeira cor alternada da linha ou null se nenhuma cor for definida.

Retornar

Color: a primeira cor de linha alternada na faixa, ou null se nenhuma cor for definida.

Autorização

Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`getFooterColumnColorObject()`

Retorna a cor da última coluna no banding, ou null se nenhuma cor for definida.

Retornar

Color: a cor da última coluna na banda ou null se nenhuma cor for definida.

Autorização

Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`getFooterRowColorObject()`

Retorna a cor da última linha na faixa ou null se nenhuma cor for definida.

Retornar

Color: a cor da linha do rodapé na banda, ou null se nenhuma cor estiver definida.

Autorização

Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`getHeaderColumnColorObject()`

Retorna a cor da primeira coluna no banding, ou null se nenhuma cor for definida.

Retornar

Color: a cor da primeira coluna na banda ou null se nenhuma cor for definida.

Autorização

Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`getHeaderRowColorObject()`

Retorna a cor da linha do cabeçalho ou null se nenhuma cor for definida.

Retornar

Color: a cor da linha do cabeçalho. Retorna null se nenhuma cor for definida.

Autorização

Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`getRange()`

Retorna o intervalo da banda.

Retornar

Range: o intervalo dessa banda.

Autorização

Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`getSecondColumnColorObject()`

Retorna a segunda cor alternada da coluna na banda ou null se nenhuma cor for definida.

Retornar

Color: a segunda cor alternada da coluna na banda ou null se nenhuma cor for definida.

Autorização

Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`getSecondRowColorObject()`

Retorna a segunda cor alternada da linha ou null se nenhuma cor for definida.

Retornar

Color: a segunda cor alternada da linha na faixa ou null, se nenhuma cor for definida.

Autorização

Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`remove()`

Remove essa faixa.

Autorização

Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`setFirstColumnColor(color)`

Define a cor da primeira coluna alternada.

Parâmetros

Nome	Tipo	Descrição
`color`	`String`	O código de cor na notação CSS (como `'#ffffff'` ou `'white'`) ou `null` para limpar a cor.

Retornar

Banding: essa faixa, para o encadeamento.

Autorização

Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`setFirstColumnColorObject(color)`

Define a primeira cor alternada da coluna nas faixas.

Parâmetros

Nome	Tipo	Descrição
`color`	`Color`	A nova cor da primeira coluna alternada na faixa. Definir como `null` apaga a cor.

Retornar

Banding: essa faixa, para o encadeamento.

Autorização

Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`setFirstRowColor(color)`

Define a cor da primeira linha alternada.

Parâmetros

Nome	Tipo	Descrição
`color`	`String`	O código de cor na notação CSS (como `'#ffffff'` ou `'white'`) ou `null` para limpar a cor.

Retornar

Banding: essa faixa, para o encadeamento.

Autorização

Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`setFirstRowColorObject(color)`

Define a primeira cor alternada da linha na faixa.

Parâmetros

Nome	Tipo	Descrição
`color`	`Color`	A nova primeira cor alternada na faixa. Definir como `null` limpa a cor.

Retornar

Banding: essa faixa, para o encadeamento.

Autorização

Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`setFooterColumnColor(color)`

Define a cor da última coluna.

Parâmetros

Nome	Tipo	Descrição
`color`	`String`	O código de cor na notação CSS (como `'#ffffff'` ou `'white'`) ou `null` para limpar a cor.

Retornar

Banding: essa faixa, para o encadeamento.

Autorização

Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`setFooterColumnColorObject(color)`

Define a cor da última coluna no banding.

Parâmetros

Nome	Tipo	Descrição
`color`	`Color`	A nova cor da última coluna no banding; definir como `null` limpa a cor.

Retornar

Banding: essa faixa, para o encadeamento.

Autorização

Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`setFooterRowColor(color)`

Define a cor da última linha.

Parâmetros

Nome	Tipo	Descrição
`color`	`String`	O código de cor na notação CSS (como `'#ffffff'` ou `'white'`) ou `null` para limpar a cor.

Retornar

Banding: essa faixa, para o encadeamento.

Autorização

Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`setFooterRowColorObject(color)`

Define a cor da linha do rodapé na banda.

Parâmetros

Nome	Tipo	Descrição
`color`	`Color`	A nova cor da linha do rodapé, definida como `null`, limpa a cor.

Retornar

Banding: essa faixa, para o encadeamento.

Autorização

Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`setHeaderColumnColor(color)`

Define a cor da coluna de cabeçalho.

Parâmetros

Nome	Tipo	Descrição
`color`	`String`	O código de cor na notação CSS (como `'#ffffff'` ou `'white'`) ou `null` para limpar a cor.

Retornar

Banding: essa faixa, para o encadeamento.

Autorização

Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`setHeaderColumnColorObject(color)`

Define a cor da coluna de cabeçalho.

Parâmetros

Nome	Tipo	Descrição
`color`	`Color`	A cor da nova coluna do cabeçalho. Definir como `null` apaga a cor.

Retornar

Banding: essa faixa, para o encadeamento.

Autorização

Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`setHeaderRowColor(color)`

Define a cor da linha do cabeçalho.

Parâmetros

Nome	Tipo	Descrição
`color`	`String`	O código de cor na notação CSS (como `'#ffffff'` ou `'white'`) ou `null` para limpar a cor.

Retornar

Banding: essa faixa, para o encadeamento.

Autorização

Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`setHeaderRowColorObject(color)`

Define a cor da linha do cabeçalho.

Parâmetros

Nome	Tipo	Descrição
`color`	`Color`	A cor da nova linha de cabeçalho. Definir como `null` apaga a cor.

Retornar

Banding: essa faixa, para o encadeamento.

Autorização

Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`setRange(range)`

Define o intervalo para estas faixas.

Parâmetros

Nome	Tipo	Descrição
`range`	`Range`	É o novo intervalo dessa faixa.

Retornar

Banding: essa faixa, para o encadeamento.

Autorização

Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`setSecondColumnColor(color)`

Define a cor da segunda coluna alternada.

Parâmetros

Nome	Tipo	Descrição
`color`	`String`	O código de cor na notação CSS (como `'#ffffff'` ou `'white'`) ou `null` para limpar a cor.

Retornar

Banding: essa faixa, para o encadeamento.

Autorização

Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`setSecondColumnColorObject(color)`

Define a segunda cor alternada da coluna nas faixas.

Parâmetros

Nome	Tipo	Descrição
`color`	`Color`	A nova segunda coluna alternada na cor da faixa. Definir como `null` apaga a cor.

Retornar

Banding: essa faixa, para o encadeamento.

Autorização

Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`setSecondRowColor(color)`

Define a cor da segunda linha alternada.

Parâmetros

Nome	Tipo	Descrição
`color`	`String`	O código de cor na notação CSS (como `'#ffffff'` ou `'white'`) ou `null` para limpar a cor.

Retornar

Banding: essa faixa, para o encadeamento.

Autorização

Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`setSecondRowColorObject(color)`

Define a segunda cor alternada na banda.

Parâmetros

Nome	Tipo	Descrição
`color`	`Color`	A nova segunda cor alternada na faixa. Definir como `null` apaga a cor.

Retornar

Banding: essa faixa, para o encadeamento.

Autorização

Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

Métodos obsoletos

`getFirstColumnColor()`

Obsoleto. Substituído por getFirstColumnColorObject()

Retorna a cor da primeira coluna alternada ou null se nenhuma cor for definida.

Retornar

String: o código de cor na notação CSS (como '#ffffff' ou 'white') ou null se nenhuma cor for definida.

Autorização

Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`getFirstRowColor()`

Obsoleto. Substituído por getFirstRowColorObject()

Retorna a cor da primeira linha alternada ou null se nenhuma cor estiver definida.

Retornar

String: o código de cor na notação CSS (como '#ffffff' ou 'white') ou null se nenhuma cor for definida.

Autorização

Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`getFooterColumnColor()`

Obsoleto. Substituído por getFooterColumnColorObject()

Retorna a cor da última coluna, ou null se nenhuma cor for definida.

Retornar

String: o código de cor na notação CSS (como '#ffffff' ou 'white') ou null se nenhuma cor for definida.

Autorização

Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`getFooterRowColor()`

Obsoleto. Substituído por getFooterRowColorObject()

Retorna a cor da última linha, ou null se nenhuma cor estiver definida.

Retornar

String: o código de cor na notação CSS (como '#ffffff' ou 'white') ou null se nenhuma cor for definida.

Autorização

Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`getHeaderColumnColor()`

Obsoleto. Substituído por getHeaderColumnColorObject()

Retorna a cor da coluna de cabeçalho ou null se nenhuma cor for definida.

Retornar

String: o código de cor na notação CSS (como '#ffffff' ou 'white') ou null se nenhuma cor for definida.

Autorização

Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`getHeaderRowColor()`

Obsoleto. Substituído por getHeaderRowColorObject()

Retorna a cor da linha do cabeçalho ou null se nenhuma cor for definida.

Retornar

String: o código de cor na notação CSS (como '#ffffff' ou 'white') ou null se nenhuma cor for definida.

Autorização

Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`getSecondColumnColor()`

Obsoleto. Substituído por getSecondColumnColorObject()

Retorna a segunda cor da coluna alternada ou null se nenhuma cor for definida.

Retornar

String: a cor HEX ou null se nenhuma cor for definida.

Autorização

Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`getSecondRowColor()`

Obsoleto. Substituído por getSecondRowColorObject()

Retorna a cor da segunda linha alternada ou null se nenhuma cor estiver definida.

Retornar

String: o código de cor na notação CSS (como '#ffffff' ou 'white') ou null se nenhuma cor for definida.

Autorização

Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets