Class Banding

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