Class Banding

Banding

Accédez aux bandes et modifiez-les. Il s'agit des 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	Copie cette bande dans une autre plage.
getFirstColumnColorObject()	Color|null	Renvoie la première couleur de colonne alternée dans la bande, ou null si aucune couleur n'est définie.
getFirstRowColorObject()	Color|null	Renvoie la première couleur de ligne alternée ou null si aucune couleur n'est définie.
getFooterColumnColorObject()	Color|null	Renvoie la couleur de la dernière colonne de la bande ou null si aucune couleur n'est définie.
getFooterRowColorObject()	Color|null	Renvoie la couleur de la dernière ligne de la bande ou null si aucune couleur n'est définie.
getHeaderColumnColorObject()	Color|null	Renvoie la couleur de la première colonne de la bande, ou null si aucune couleur n'est définie.
getHeaderRowColorObject()	Color|null	Renvoie la couleur de la ligne d'en-tête ou null si aucune couleur n'est définie.
getRange()	Range	Renvoie la plage pour cette bande.
getSecondColumnColorObject()	Color|null	Renvoie la deuxième couleur de colonne alternée dans la bande, ou null si aucune couleur n'est définie.
getSecondRowColorObject()	Color|null	Renvoie la deuxième couleur de ligne alternée ou null si aucune couleur n'est définie.
remove()	void	Supprime cette bande.
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 dans 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 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 la bande.
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 pour cette bande.
setSecondColumnColor(color)	Banding	Définit la couleur de la deuxième colonne utilisée en alternance.
setSecondColumnColorObject(color)	Banding	Définit la deuxième couleur de colonne en alternance dans la bande.
setSecondRowColor(color)	Banding	Définit la deuxième couleur de ligne utilisée en alternance.
setSecondRowColorObject(color)	Banding	Définit la deuxième couleur en alternance dans la bande.

Méthodes obsolètes

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

Documentation détaillée

copyTo(range)

Copie cette bande dans une autre plage.

Paramètres

Nom	Type	Description
range	Range	Plage à laquelle appliquer cette mise en forme conditionnelle.

Renvois

Banding : nouvelle bande.

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des scopes 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|null : 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 scopes 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|null : 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 scopes 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|null : 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 scopes 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|null : 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 scopes 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|null : 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 scopes 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|null : 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 scopes suivants :

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

---

getRange()

Renvoie la plage pour 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 scopes 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|null : deuxième couleur de colonne en alternance 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 scopes 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|null : 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 scopes suivants :

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

---

remove()

Supprime cette bande.

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des scopes 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 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 scopes 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 première couleur de colonne alternée dans la bande. Si vous définissez la valeur sur 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 scopes 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 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 scopes 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. Si vous définissez la valeur sur 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 scopes 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 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 scopes 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. Si vous définissez la valeur sur 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 scopes 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 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 scopes 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 la bande.

Paramètres

Nom	Type	Description
color	Color	Nouvelle couleur de la ligne de pied de page. Si vous définissez la valeur sur 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 scopes 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 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 scopes 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	La nouvelle couleur de la colonne d'en-tête. Si vous définissez la valeur sur 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 scopes 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 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 scopes 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. Si vous définissez la valeur sur 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 scopes suivants :

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

---

setRange(range)

Définit la plage pour cette bande.

Paramètres

Nom	Type	Description
range	Range	Nouvelle plage pour 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 scopes 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 utilisée en alternance.

Paramètres

Nom	Type	Description
color	String	Code 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 scopes 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 la bande.

Paramètres

Nom	Type	Description
color	Color	Nouvelle deuxième couleur de colonne alternée dans la bande. Si vous définissez la valeur sur 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 scopes suivants :

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

---

setSecondRowColor(color)

Définit la deuxième couleur de ligne utilisée en alternance.

Paramètres

Nom	Type	Description
color	String	Code 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 scopes suivants :

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

---

setSecondRowColorObject(color)

Définit la deuxième couleur en alternance dans la bande.

Paramètres

Nom	Type	Description
color	Color	Nouvelle deuxième couleur alternée dans la bande. Si vous définissez la valeur sur 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 scopes 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 alternée ou null si aucune couleur n'est définie.

Renvois

String|null : code 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 scopes suivants :

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

---

getFirstRowColor()

Obsolète. Remplacé par getFirstRowColorObject()

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

Renvois

String|null : code 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 scopes 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|null : code 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 scopes 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|null : code 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 scopes 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|null : code 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 scopes 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|null : code 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 scopes suivants :

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

---

getSecondColumnColor()

Obsolète. Remplacé par getSecondColumnColorObject()

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

Renvois

String|null : 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 scopes suivants :

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

---

getSecondRowColor()

Obsolète. Remplacé par getSecondRowColorObject()

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

Renvois

String|null : code 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 scopes suivants :

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