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

Class Banding

Affichez et modifiez les bandes, les motifs de couleur appliqués aux lignes ou aux colonnes d'une plage. 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`	Il copie cette bande dans une autre plage.
`getFirstColumnColorObject()`	`Color`	Renvoie la première couleur de colonne en alternance dans le panneau ou la valeur `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 du panneau ou la valeur `null` si aucune couleur n'est définie.
`getFooterRowColorObject()`	`Color`	Renvoie la couleur de la dernière ligne du panneau ou la valeur `null` si aucune couleur n'est définie.
`getHeaderColumnColorObject()`	`Color`	Renvoie la couleur de la première colonne du panneau ou la valeur `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 bandes.
`getSecondColumnColorObject()`	`Color`	Renvoie la deuxième couleur de colonne en alternance dans le panneau ou la valeur `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 ce bandage.
`setFirstColumnColor(color)`	`Banding`	Définit la couleur de la première colonne en alternance.
`setFirstColumnColorObject(color)`	`Banding`	Définit la première couleur de colonne alternée de la bande.
`setFirstRowColor(color)`	`Banding`	Définit la couleur de la première ligne en alternance.
`setFirstRowColorObject(color)`	`Banding`	Définit la première couleur de ligne alternée de 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 du panneau.
`setFooterRowColor(color)`	`Banding`	Définit la couleur de la dernière ligne.
`setFooterRowColorObject(color)`	`Banding`	Définit la couleur de la ligne du pied de page du panneau.
`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 bandes concernée.
`setSecondColumnColor(color)`	`Banding`	Définit la couleur de la deuxième colonne en alternance.
`setSecondColumnColorObject(color)`	`Banding`	Définit la deuxième couleur de colonne en alternance dans le panneau.
`setSecondRowColor(color)`	`Banding`	Définit la couleur de la deuxième ligne en alternance.
`setSecondRowColorObject(color)`	`Banding`	Définit la seconde couleur d'alternance dans le bracelet.

Méthodes obsolètes

Méthode	Type renvoyé	Brève description
`getFirstColumnColor()`	`String`	Renvoie la couleur de la première colonne en alternance, ou `null` si aucune couleur n'est définie.
`getFirstRowColor()`	`String`	Renvoie la couleur de la première ligne qui est alternée 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 en alternance, 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)`

Il copie cette bande dans une autre plage.

Paramètres

Nom	Type	Description
`range`	`Range`	Plage sur laquelle copier ce bandage.

Aller-retour

Banding : le nouveau bandage.

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 en alternance dans le panneau ou la valeur null si aucune couleur n'est définie.

Aller-retour

Color : première couleur de colonne en alternance dans le bandage, 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.

Aller-retour

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 du panneau ou la valeur null si aucune couleur n'est définie.

Aller-retour

Color : dernière couleur de colonne du panneau 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 du panneau ou la valeur null si aucune couleur n'est définie.

Aller-retour

Color : couleur de la ligne du pied de page dans les bandes, 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 du panneau ou la valeur null si aucune couleur n'est définie.

Aller-retour

Color : couleur de la première colonne du panneau 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.

Aller-retour

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 bandes.

Aller-retour

Range : plage concernée par le bandage.

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 en alternance dans le panneau ou la valeur null si aucune couleur n'est définie.

Aller-retour

Color : deuxième couleur de colonne alternée dans le ruban, 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.

Aller-retour

Color : deuxième couleur de ligne alternée dans le bandage, 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 ce bandage.

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 en alternance.

Paramètres

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

Aller-retour

Banding : ce bandage, 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 de la bande.

Paramètres

Nom	Type	Description
`color`	`Color`	Nouvelle couleur de colonne alternée dans la bande. Si la valeur est `null`, la couleur est supprimée.

Aller-retour

Banding : ce bandage, 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 en alternance.

Paramètres

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

Aller-retour

Banding : ce bandage, 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 de la bande.

Paramètres

Nom	Type	Description
`color`	`Color`	Nouvelle couleur de rotation dans la bande ; le fait de définir la couleur sur `null` efface la couleur.

Aller-retour

Banding : ce bandage, 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.

Aller-retour

Banding : ce bandage, 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 du panneau.

Paramètres

Nom	Type	Description
`color`	`Color`	Nouvelle couleur de la dernière colonne du bandage. Si la valeur est `null`, la couleur est supprimée.

Aller-retour

Banding : ce bandage, 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.

Aller-retour

Banding : ce bandage, 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 du pied de page du panneau.

Paramètres

Nom	Type	Description
`color`	`Color`	Nouvelle couleur de la ligne du pied de page ; le fait de définir la couleur sur `null` efface la couleur.

Aller-retour

Banding : ce bandage, 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.

Aller-retour

Banding : ce bandage, 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 supprimée.

Aller-retour

Banding : ce bandage, 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.

Aller-retour

Banding : ce bandage, 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 ligne d'en-tête ; le paramètre `null` permet de supprimer la couleur.

Aller-retour

Banding : ce bandage, 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 bandes concernée.

Paramètres

Nom	Type	Description
`range`	`Range`	Nouvelle plage pour ce bandage.

Aller-retour

Banding : ce bandage, 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 en alternance.

Paramètres

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

Aller-retour

Banding : ce bandage, 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 en alternance dans le panneau.

Paramètres

Nom	Type	Description
`color`	`Color`	La deuxième couleur de colonne alternée dans le bandage. Si la valeur est `null`, la couleur est supprimée.

Aller-retour

Banding : ce bandage, 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 en alternance.

Paramètres

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

Aller-retour

Banding : ce bandage, 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 seconde couleur d'alternance dans le bracelet.

Paramètres

Nom	Type	Description
`color`	`Color`	La deuxième couleur alternée dans la bande ; le fait de définir la valeur sur `null` efface la couleur.

Aller-retour

Banding : ce bandage, 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 couleur de la première colonne en alternance, ou null si aucune couleur n'est définie.

Aller-retour

String : code couleur au format 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 est alternée ou null si aucune couleur n'est définie.

Aller-retour

String : code couleur au format 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.

Aller-retour

String : code couleur au format 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.

Aller-retour

String : code couleur au format 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.

Aller-retour

String : code couleur au format 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.

Aller-retour

String : code couleur au format 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 en alternance, ou null si aucune couleur n'est définie.

Aller-retour

String : couleur HEX 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.

Aller-retour

String : code couleur au format 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