Class Slicer

Trancheuse

Représente un segment permettant de filtrer des plages, des graphiques et des tableaux croisés dynamiques de manière non collaborative. Cette classe contient des méthodes permettant d'accéder aux segments existants et de les modifier. Pour créer un segment, utilisez Sheet.insertSlicer(range, anchorRowPos, anchorColPos).

Méthodes

MéthodeType renvoyéBrève description
getBackgroundColorObject()ColorRenvoyez l'arrière-plan Color du segment.
getColumnPosition()IntegerRenvoie la position de colonne (par rapport à la plage de données du segment) sur laquelle le filtre est appliqué dans le segment, ou null si la position de la colonne n'est pas définie.
getContainerInfo()ContainerInfoRécupère des informations sur la position du segment dans la feuille.
getFilterCriteria()FilterCriteriaRenvoie les critères de filtre du segment, ou null si les critères de filtre ne sont pas définis.
getRange()RangeRécupère la plage de données à laquelle le segment est appliqué.
getTitle()StringRenvoie le titre du segment.
getTitleHorizontalAlignment()StringRécupère l'alignement horizontal du titre.
getTitleTextStyle()TextStyleRenvoie le style de texte du titre du segment.
isAppliedToPivotTables()BooleanIndique si le segment donné est appliqué aux tableaux croisés dynamiques.
remove()voidSupprime le segment.
setApplyToPivotTables(applyToPivotTables)SlicerDéfinit si le segment donné doit être appliqué aux tableaux croisés dynamiques de la feuille de calcul.
setBackgroundColor(color)SlicerDéfinit la couleur d'arrière-plan du segment.
setBackgroundColorObject(color)SlicerDéfinit l'arrière-plan Color du segment.
setColumnFilterCriteria(columnPosition, filterCriteria)SlicerDéfinit l'index de colonne et les critères de filtrage du segment.
setPosition(anchorRowPos, anchorColPos, offsetX, offsetY)SlicerDéfinit la position du segment sur la feuille.
setRange(rangeApi)SlicerDéfinit la plage de données à laquelle le segment est appliqué.
setTitle(title)SlicerDéfinit le titre du segment.
setTitleHorizontalAlignment(horizontalAlignment)SlicerDéfinit l'alignement horizontal du titre dans le segment.
setTitleTextStyle(textStyle)SlicerDéfinit le style de texte du segment.

Documentation détaillée

getBackgroundColorObject()

Renvoyez l'arrière-plan Color du segment.

Renvois

Color : couleur d'arrière-plan de ce segment. Renvoie null si aucune couleur n'est définie.

Autorisation

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

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

getColumnPosition()

Renvoie la position de colonne (par rapport à la plage de données du segment) sur laquelle le filtre est appliqué dans le segment, ou null si la position de la colonne n'est pas définie. Il doit s'agir d'une position indexée sur 1 de la colonne, semblable au filtre.

Renvois

Integer : position de la colonne de ce segment.

Autorisation

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

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

getContainerInfo()

Récupère des informations sur la position du segment dans la feuille.

Renvois

ContainerInfo : objet contenant la position du conteneur du segment.

Autorisation

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

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

getFilterCriteria()

Renvoie les critères de filtre du segment, ou null si les critères de filtre ne sont pas définis.

Renvois

FilterCriteria : critères de filtre de ce segment.

Autorisation

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

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

getRange()

Récupère la plage de données à laquelle le segment est appliqué.

Renvois

Range : plage du segment.

Autorisation

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

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

getTitle()

Renvoie le titre du segment.

Renvois

String : segment pour le chaînage.

Autorisation

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

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

getTitleHorizontalAlignment()

Récupère l'alignement horizontal du titre.

Renvois

String : alignement horizontal du titre de ce segment.

Autorisation

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

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

getTitleTextStyle()

Renvoie le style de texte du titre du segment.

Renvois

TextStyle : style de texte du titre de ce segment.

Autorisation

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

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

isAppliedToPivotTables()

Indique si le segment donné est appliqué aux tableaux croisés dynamiques.

Renvois

Boolean : true si ce segment est appliqué à des tableaux croisés dynamiques, sinon false.

Autorisation

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

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

remove()

Supprime le segment.

Autorisation

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

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

setApplyToPivotTables(applyToPivotTables)

Définit si le segment donné doit être appliqué aux tableaux croisés dynamiques de la feuille de calcul.

Paramètres

NomTypeDescription
applyToPivotTablesBooleanIndique si ce segment doit s'appliquer aux tableaux croisés dynamiques.

Renvois

Slicer : segment pour le chaînage.

Autorisation

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

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

setBackgroundColor(color)

Définit la couleur d'arrière-plan du segment. Une valeur null réinitialise la couleur d'arrière-plan.

Paramètres

NomTypeDescription
colorStringNouvelle couleur d'arrière-plan de ce segment en notation CSS (#ffffff, par exemple).

Renvois

Slicer : segment pour le chaînage.

Autorisation

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

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

setBackgroundColorObject(color)

Définit l'arrière-plan Color du segment. Une valeur null réinitialise la couleur de l'arrière-plan.

Paramètres

NomTypeDescription
colorColorNouvelle couleur d'arrière-plan de ce segment.

Renvois

Slicer : segment pour le chaînage.

Autorisation

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

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

setColumnFilterCriteria(columnPosition, filterCriteria)

Définit l'index de colonne et les critères de filtrage du segment. La valeur null réinitialise le filtre du segment.

Paramètres

NomTypeDescription
columnPositionIntegerNouvelle position de colonne de ce segment.
filterCriteriaFilterCriteriaNouveaux critères de filtre de ce segment.

Renvois

Slicer : segment pour le chaînage.

Autorisation

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

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

setPosition(anchorRowPos, anchorColPos, offsetX, offsetY)

Définit la position du segment sur la feuille. Les indices de position des lignes et des colonnes d'ancres ont un indice de 1.

Paramètres

NomTypeDescription
anchorRowPosIntegerLe côté supérieur du segment est ancré sur cette ligne.
anchorColPosIntegerLa partie supérieure du segment est ancrée dans ce col.
offsetXIntegerDécalage horizontal à partir de l'angle de la cellule, en pixels.
offsetYIntegerDécalage vertical depuis l'angle de la cellule, en pixels.

Renvois

Slicer : segment pour le chaînage.

Autorisation

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

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

setRange(rangeApi)

Définit la plage de données à laquelle le segment est appliqué.

Paramètres

NomTypeDescription
rangeApiRangeNouvelle plage pour ce segment.

Renvois

Slicer : segment pour le chaînage.

Autorisation

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

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

setTitle(title)

Définit le titre du segment. Si le titre est vide, la valeur par défaut du titre est rétablie.

Paramètres

NomTypeDescription
titleStringNouveau titre de ce segment.

Renvois

Slicer : segment pour le chaînage.

Autorisation

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

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

setTitleHorizontalAlignment(horizontalAlignment)

Définit l'alignement horizontal du titre dans le segment. La valeur null réinitialise l'alignement.

Paramètres

NomTypeDescription
horizontalAlignmentStringNouvel alignement horizontal du titre de ce segment.

Renvois

Slicer : segment pour le chaînage.

Autorisation

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

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

setTitleTextStyle(textStyle)

Définit le style de texte du segment.

Paramètres

NomTypeDescription
textStyleTextStyleNouveau style de texte du titre du segment.

Renvois

Slicer : segment pour le chaînage.

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation associée à 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