Cette page a été traduite par l'API Cloud Translation.

Class Banding

Accédez aux bandes, c'est-à-dire aux motifs de couleurs appliqués aux lignes ou aux colonnes d'une plage, et modifiez-les. Chaque bande se compose d'une plage et d'un ensemble de couleurs pour les lignes, les colonnes, les en-têtes et les pieds de page.

Méthodes

Méthode	Type renvoyé	Brève description
`copyTo(range)`	`Banding`	Copier cette bande dans une autre plage
`getFirstColumnColorObject()`	`Color`	Renvoie la première couleur de colonne alternée dans la bande, ou `null` si aucune couleur n'est définie.
`getFirstRowColorObject()`	`Color`	Renvoie la première couleur de ligne alternée, ou `null` si aucune couleur n'est définie.
`getFooterColumnColorObject()`	`Color`	Renvoie la couleur de la dernière colonne de la bande, ou `null` si aucune couleur n'est définie.
`getFooterRowColorObject()`	`Color`	Renvoie la couleur de la dernière ligne de la bande, ou `null` si aucune couleur n'est définie.
`getHeaderColumnColorObject()`	`Color`	Renvoie la couleur de la première colonne de la bande, ou `null` si aucune couleur n'est définie.
`getHeaderRowColorObject()`	`Color`	Renvoie la couleur de la ligne d'en-tête ou `null` si aucune couleur n'est définie.
`getRange()`	`Range`	Renvoie la plage de cette bande.
`getSecondColumnColorObject()`	`Color`	Renvoie la deuxième couleur de colonne alternée dans la bande, ou `null` si aucune couleur n'est définie.
`getSecondRowColorObject()`	`Color`	Renvoie la deuxième couleur de ligne alternée, ou `null` si aucune couleur n'est définie.
`remove()`	`void`	Supprime ces bandes.
`setFirstColumnColor(color)`	`Banding`	Définit la couleur de la première colonne qui alterne.
`setFirstColumnColorObject(color)`	`Banding`	Définit la première couleur de colonne alternée dans la bande.
`setFirstRowColor(color)`	`Banding`	Définit la couleur de la première ligne qui alterne.
`setFirstRowColorObject(color)`	`Banding`	Définit la première couleur de ligne alternée dans la bande.
`setFooterColumnColor(color)`	`Banding`	Définit la couleur de la dernière colonne.
`setFooterColumnColorObject(color)`	`Banding`	Définit la couleur de la dernière colonne de la bande.
`setFooterRowColor(color)`	`Banding`	Définit la couleur de la dernière ligne.
`setFooterRowColorObject(color)`	`Banding`	Définit la couleur de la ligne de pied de page dans le groupe.
`setHeaderColumnColor(color)`	`Banding`	Définit la couleur de la colonne d'en-tête.
`setHeaderColumnColorObject(color)`	`Banding`	Définit la couleur de la colonne d'en-tête.
`setHeaderRowColor(color)`	`Banding`	Définit la couleur de la ligne d'en-tête.
`setHeaderRowColorObject(color)`	`Banding`	Définit la couleur de la ligne d'en-tête.
`setRange(range)`	`Banding`	Définit la plage de cette bande.
`setSecondColumnColor(color)`	`Banding`	Définit la couleur de la deuxième colonne qui alterne.
`setSecondColumnColorObject(color)`	`Banding`	Définit la deuxième couleur de colonne alternée dans la bande.
`setSecondRowColor(color)`	`Banding`	Définit la couleur de la deuxième ligne qui alterne.
`setSecondRowColorObject(color)`	`Banding`	Définit la deuxième couleur alternée dans les bandes.

Méthodes obsolètes

Méthode	Type renvoyé	Brève description
`getFirstColumnColor()`	`String`	Renvoie la première couleur de colonne qui alterne, ou `null` si aucune couleur n'est définie.
`getFirstRowColor()`	`String`	Renvoie la couleur de la première ligne qui alterne ou `null` si aucune couleur n'est définie.
`getFooterColumnColor()`	`String`	Renvoie la couleur de la dernière colonne, ou `null` si aucune couleur n'est définie.
`getFooterRowColor()`	`String`	Renvoie la couleur de la dernière ligne ou `null` si aucune couleur n'est définie.
`getHeaderColumnColor()`	`String`	Renvoie la couleur de la colonne d'en-tête, ou `null` si aucune couleur n'est définie.
`getHeaderRowColor()`	`String`	Renvoie la couleur de la ligne d'en-tête ou `null` si aucune couleur n'est définie.
`getSecondColumnColor()`	`String`	Renvoie la couleur de la deuxième colonne qui alterne, ou `null` si aucune couleur n'est définie.
`getSecondRowColor()`	`String`	Renvoie la couleur de la deuxième ligne qui est alternée ou `null` si aucune couleur n'est définie.

Documentation détaillée

`copyTo(range)`

Copier cette bande dans une autre plage

Paramètres

Nom	Type	Description
`range`	`Range`	Plage dans laquelle copier cette bande.

Renvois

Banding : nouveau groupe.

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des champs d'application suivants:

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

`getFirstColumnColorObject()`

Renvoie la première couleur de colonne alternée dans la bande, ou null si aucune couleur n'est définie.

Renvois

Color : première couleur de colonne alternée dans la bande, ou null si aucune couleur n'est définie.

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des champs d'application suivants:

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

`getFirstRowColorObject()`

Renvoie la première couleur de ligne alternée, ou null si aucune couleur n'est définie.

Renvois

Color : première couleur de ligne alternée dans la bande, ou null si aucune couleur n'est définie.

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des champs d'application suivants:

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

`getFooterColumnColorObject()`

Renvoie la couleur de la dernière colonne de la bande, ou null si aucune couleur n'est définie.

Renvois

Color : couleur de la dernière colonne de la bande, ou null si aucune couleur n'est définie.

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des champs d'application suivants:

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

`getFooterRowColorObject()`

Renvoie la couleur de la dernière ligne de la bande, ou null si aucune couleur n'est définie.

Renvois

Color : couleur de la ligne de pied de page dans la bande, ou null si aucune couleur n'est définie.

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des champs d'application suivants:

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

`getHeaderColumnColorObject()`

Renvoie la couleur de la première colonne de la bande, ou null si aucune couleur n'est définie.

Renvois

Color : couleur de la première colonne de la bande, ou null si aucune couleur n'est définie.

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des champs d'application suivants:

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

`getHeaderRowColorObject()`

Renvoie la couleur de la ligne d'en-tête ou null si aucune couleur n'est définie.

Renvois

Color : couleur de la ligne d'en-tête. Renvoie null si aucune couleur n'est définie.

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des champs d'application suivants:

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

`getRange()`

Renvoie la plage de cette bande.

Renvois

Range : plage de cette bande.

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des champs d'application suivants:

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

`getSecondColumnColorObject()`

Renvoie la deuxième couleur de colonne alternée dans la bande, ou null si aucune couleur n'est définie.

Renvois

Color : deuxième couleur de colonne alternée dans la bande, ou null si aucune couleur n'est définie.

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des champs d'application suivants:

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

`getSecondRowColorObject()`

Renvoie la deuxième couleur de ligne alternée, ou null si aucune couleur n'est définie.

Renvois

Color : deuxième couleur de ligne alternée dans la bande, ou null si aucune couleur n'est définie.

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des champs d'application suivants:

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

`remove()`

Supprime ces bandes.

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des champs d'application suivants:

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

`setFirstColumnColor(color)`

Définit la couleur de la première colonne qui alterne.

Paramètres

Nom	Type	Description
`color`	`String`	Code de couleur en notation CSS (par exemple, `'#ffffff'` ou `'white'`), ou `null` pour effacer la couleur.

Renvois

Banding : cette bande, pour le chaînage.

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des champs d'application suivants:

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

`setFirstColumnColorObject(color)`

Définit la première couleur de colonne alternée dans la bande.

Paramètres

Nom	Type	Description
`color`	`Color`	Nouvelle couleur de la première colonne alternée dans la bande. La valeur `null` effacera la couleur.

Renvois

Banding : cette bande, pour le chaînage.

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des champs d'application suivants:

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

`setFirstRowColor(color)`

Définit la couleur de la première ligne qui alterne.

Paramètres

Nom	Type	Description
`color`	`String`	Code de couleur en notation CSS (par exemple, `'#ffffff'` ou `'white'`), ou `null` pour effacer la couleur.

Renvois

Banding : cette bande, pour le chaînage.

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des champs d'application suivants:

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

`setFirstRowColorObject(color)`

Définit la première couleur de ligne alternée dans la bande.

Paramètres

Nom	Type	Description
`color`	`Color`	Nouvelle première couleur alternée dans la bande. La valeur `null` efface la couleur.

Renvois

Banding : cette bande, pour le chaînage.

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des champs d'application suivants:

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

`setFooterColumnColor(color)`

Définit la couleur de la dernière colonne.

Paramètres

Nom	Type	Description
`color`	`String`	Code de couleur en notation CSS (par exemple, `'#ffffff'` ou `'white'`), ou `null` pour effacer la couleur.

Renvois

Banding : cette bande, pour le chaînage.

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des champs d'application suivants:

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

`setFooterColumnColorObject(color)`

Définit la couleur de la dernière colonne de la bande.

Paramètres

Nom	Type	Description
`color`	`Color`	Nouvelle couleur de la dernière colonne de la bande. La valeur `null` efface la couleur.

Renvois

Banding : cette bande, pour le chaînage.

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des champs d'application suivants:

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

`setFooterRowColor(color)`

Définit la couleur de la dernière ligne.

Paramètres

Nom	Type	Description
`color`	`String`	Code de couleur en notation CSS (par exemple, `'#ffffff'` ou `'white'`), ou `null` pour effacer la couleur.

Renvois

Banding : cette bande, pour le chaînage.

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des champs d'application suivants:

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

`setFooterRowColorObject(color)`

Définit la couleur de la ligne de pied de page dans le groupe.

Paramètres

Nom	Type	Description
`color`	`Color`	Nouvelle couleur de la ligne du pied de page. La valeur `null` efface la couleur.

Renvois

Banding : cette bande, pour le chaînage.

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des champs d'application suivants:

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

`setHeaderColumnColor(color)`

Définit la couleur de la colonne d'en-tête.

Paramètres

Nom	Type	Description
`color`	`String`	Code de couleur en notation CSS (par exemple, `'#ffffff'` ou `'white'`), ou `null` pour effacer la couleur.

Renvois

Banding : cette bande, pour le chaînage.

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des champs d'application suivants:

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

`setHeaderColumnColorObject(color)`

Définit la couleur de la colonne d'en-tête.

Paramètres

Nom	Type	Description
`color`	`Color`	Nouvelle couleur de la colonne d'en-tête. Si la valeur est `null`, la couleur est effacée.

Renvois

Banding : cette bande, pour le chaînage.

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des champs d'application suivants:

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

`setHeaderRowColor(color)`

Définit la couleur de la ligne d'en-tête.

Paramètres

Nom	Type	Description
`color`	`String`	Code de couleur en notation CSS (par exemple, `'#ffffff'` ou `'white'`), ou `null` pour effacer la couleur.

Renvois

Banding : cette bande, pour le chaînage.

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des champs d'application suivants:

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

`setHeaderRowColorObject(color)`

Définit la couleur de la ligne d'en-tête.

Paramètres

Nom	Type	Description
`color`	`Color`	Nouvelle couleur de la ligne d'en-tête. La valeur `null` efface la couleur.

Renvois

Banding : cette bande, pour le chaînage.

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des champs d'application suivants:

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

`setRange(range)`

Définit la plage de cette bande.

Paramètres

Nom	Type	Description
`range`	`Range`	Nouvelle plage de cette bande.

Renvois

Banding : cette bande, pour le chaînage.

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des champs d'application suivants:

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

`setSecondColumnColor(color)`

Définit la couleur de la deuxième colonne qui alterne.

Paramètres

Nom	Type	Description
`color`	`String`	Code de couleur en notation CSS (par exemple, `'#ffffff'` ou `'white'`), ou `null` pour effacer la couleur.

Renvois

Banding : cette bande, pour le chaînage.

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des champs d'application suivants:

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

`setSecondColumnColorObject(color)`

Définit la deuxième couleur de colonne alternée dans la bande.

Paramètres

Nom	Type	Description
`color`	`Color`	Nouvelle couleur de la deuxième colonne alternée dans la bande. La valeur `null` effacera la couleur.

Renvois

Banding : cette bande, pour le chaînage.

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des champs d'application suivants:

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

`setSecondRowColor(color)`

Définit la couleur de la deuxième ligne qui alterne.

Paramètres

Nom	Type	Description
`color`	`String`	Code de couleur en notation CSS (par exemple, `'#ffffff'` ou `'white'`), ou `null` pour effacer la couleur.

Renvois

Banding : cette bande, pour le chaînage.

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des champs d'application suivants:

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

`setSecondRowColorObject(color)`

Définit la deuxième couleur alternée dans les bandes.

Paramètres

Nom	Type	Description
`color`	`Color`	Nouvelle deuxième couleur alternée dans la bande. La valeur `null` efface la couleur.

Renvois

Banding : cette bande, pour le chaînage.

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des champs d'application suivants:

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

Méthodes obsolètes

`getFirstColumnColor()`

Obsolète. Remplacé par getFirstColumnColorObject()

Renvoie la première couleur de colonne qui alterne, ou null si aucune couleur n'est définie.

Renvois

String : code de couleur en notation CSS (par exemple, '#ffffff' ou 'white'), ou null si aucune couleur n'est définie.

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des champs d'application suivants:

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

`getFirstRowColor()`

Obsolète. Remplacé par getFirstRowColorObject()

Renvoie la couleur de la première ligne qui alterne ou null si aucune couleur n'est définie.

Renvois

String : code de couleur en notation CSS (par exemple, '#ffffff' ou 'white'), ou null si aucune couleur n'est définie.

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des champs d'application suivants:

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

`getFooterColumnColor()`

Obsolète. Remplacé par getFooterColumnColorObject()

Renvoie la couleur de la dernière colonne, ou null si aucune couleur n'est définie.

Renvois

String : code de couleur en notation CSS (par exemple, '#ffffff' ou 'white'), ou null si aucune couleur n'est définie.

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des champs d'application suivants:

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

`getFooterRowColor()`

Obsolète. Remplacé par getFooterRowColorObject()

Renvoie la couleur de la dernière ligne ou null si aucune couleur n'est définie.

Renvois

String : code de couleur en notation CSS (par exemple, '#ffffff' ou 'white'), ou null si aucune couleur n'est définie.

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des champs d'application suivants:

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

`getHeaderColumnColor()`

Obsolète. Remplacé par getHeaderColumnColorObject()

Renvoie la couleur de la colonne d'en-tête, ou null si aucune couleur n'est définie.

Renvois

String : code de couleur en notation CSS (par exemple, '#ffffff' ou 'white'), ou null si aucune couleur n'est définie.

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des champs d'application suivants:

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

`getHeaderRowColor()`

Obsolète. Remplacé par getHeaderRowColorObject()

Renvoie la couleur de la ligne d'en-tête ou null si aucune couleur n'est définie.

Renvois

String : code de couleur en notation CSS (par exemple, '#ffffff' ou 'white'), ou null si aucune couleur n'est définie.

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des champs d'application suivants:

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

`getSecondColumnColor()`

Obsolète. Remplacé par getSecondColumnColorObject()

Renvoie la couleur de la deuxième colonne qui alterne, ou null si aucune couleur n'est définie.

Renvois

String : couleur hexadécimale ou null si aucune couleur n'est définie.

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des champs d'application suivants:

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

`getSecondRowColor()`

Obsolète. Remplacé par getSecondRowColorObject()

Renvoie la couleur de la deuxième ligne qui est alternée ou null si aucune couleur n'est définie.

Renvois

String : code de couleur en notation CSS (par exemple, '#ffffff' ou 'white'), ou null si aucune couleur n'est définie.

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des champs d'application suivants:

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