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éthodeType renvoyéBrève description
copyTo(range)BandingCopie cette bande dans une autre plage.
getFirstColumnColorObject()Color|nullRenvoie la première couleur de colonne alternée dans la bande, ou null si aucune couleur n'est définie.
getFirstRowColorObject()Color|nullRenvoie la première couleur de ligne alternée ou null si aucune couleur n'est définie.
getFooterColumnColorObject()Color|nullRenvoie la couleur de la dernière colonne de la bande ou null si aucune couleur n'est définie.
getFooterRowColorObject()Color|nullRenvoie la couleur de la dernière ligne de la bande ou null si aucune couleur n'est définie.
getHeaderColumnColorObject()Color|nullRenvoie la couleur de la première colonne de la bande, ou null si aucune couleur n'est définie.
getHeaderRowColorObject()Color|nullRenvoie la couleur de la ligne d'en-tête ou null si aucune couleur n'est définie.
getRange()RangeRenvoie la plage pour cette bande.
getSecondColumnColorObject()Color|nullRenvoie la deuxième couleur de colonne alternée dans la bande, ou null si aucune couleur n'est définie.
getSecondRowColorObject()Color|nullRenvoie la deuxième couleur de ligne alternée ou null si aucune couleur n'est définie.
remove()voidSupprime cette bande.
setFirstColumnColor(color)BandingDéfinit la couleur de la première colonne en alternance.
setFirstColumnColorObject(color)BandingDéfinit la première couleur de colonne alternée dans la bande.
setFirstRowColor(color)BandingDéfinit la couleur de la première ligne en alternance.
setFirstRowColorObject(color)BandingDéfinit la première couleur de ligne alternée dans la bande.
setFooterColumnColor(color)BandingDéfinit la couleur de la dernière colonne.
setFooterColumnColorObject(color)BandingDéfinit la couleur de la dernière colonne de la bande.
setFooterRowColor(color)BandingDéfinit la couleur de la dernière ligne.
setFooterRowColorObject(color)BandingDéfinit la couleur de la ligne de pied de page dans la bande.
setHeaderColumnColor(color)BandingDéfinit la couleur de la colonne d'en-tête.
setHeaderColumnColorObject(color)BandingDéfinit la couleur de la colonne d'en-tête.
setHeaderRowColor(color)BandingDéfinit la couleur de la ligne d'en-tête.
setHeaderRowColorObject(color)BandingDéfinit la couleur de la ligne d'en-tête.
setRange(range)BandingDéfinit la plage pour cette bande.
setSecondColumnColor(color)BandingDéfinit la couleur de la deuxième colonne utilisée en alternance.
setSecondColumnColorObject(color)BandingDéfinit la deuxième couleur de colonne en alternance dans la bande.
setSecondRowColor(color)BandingDéfinit la couleur de la deuxième ligne utilisée en alternance.
setSecondRowColorObject(color)BandingDéfinit la deuxième couleur en alternance dans la bande.

Documentation détaillée

copyTo(range)

Copie cette bande dans une autre plage.

Paramètres

NomTypeDescription
rangeRangePlage à 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

NomTypeDescription
colorStringCode 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

NomTypeDescription
colorColorNouvelle 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

NomTypeDescription
colorStringCode 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

NomTypeDescription
colorColorNouvelle 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

NomTypeDescription
colorStringCode 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

NomTypeDescription
colorColorNouvelle 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

NomTypeDescription
colorStringCode 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

NomTypeDescription
colorColorNouvelle 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

NomTypeDescription
colorStringCode 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

NomTypeDescription
colorColorLa 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

NomTypeDescription
colorStringCode 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

NomTypeDescription
colorColorNouvelle 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

NomTypeDescription
rangeRangeNouvelle 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

NomTypeDescription
colorStringCode 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

NomTypeDescription
colorColorNouvelle 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 couleur de la deuxième ligne utilisée en alternance.

Paramètres

NomTypeDescription
colorStringCode 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

NomTypeDescription
colorColorNouvelle 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