Class Slicer

Trancheur

Représente une segmentation, qui permet de filtrer les plages, les graphiques et les 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 la 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 l'emplacement du segment dans la feuille.
getFilterCriteria()FilterCriteriaRenvoie les critères de filtrage du segment ou null s'ils 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étermine 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.

Aller-retour

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 avec 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 la 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 de 1 colonne, semblable au filtre.

Aller-retour

Integer : position de la colonne de ce segment.

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

getContainerInfo()

Récupère des informations sur l'emplacement du segment dans la feuille.

Aller-retour

ContainerInfo : objet contenant la position du conteneur du segment.

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

getFilterCriteria()

Renvoie les critères de filtrage du segment ou null s'ils ne sont pas définis.

Aller-retour

FilterCriteria : critères de filtre de ce segment.

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()

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

Aller-retour

Range : plage de segments.

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

getTitle()

Renvoie le titre du segment.

Aller-retour

String : ce segment est utilisé 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

getTitleHorizontalAlignment()

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

Aller-retour

String : alignement horizontal du titre de ce segment.

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

getTitleTextStyle()

Renvoie le style de texte du titre du segment.

Aller-retour

TextStyle : style de texte du titre de ce segment.

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

isAppliedToPivotTables()

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

Aller-retour

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

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 le segment.

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

setApplyToPivotTables(applyToPivotTables)

Détermine 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.

Aller-retour

Slicer : ce segment est utilisé 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

setBackgroundColor(color)

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

Paramètres

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

Aller-retour

Slicer : ce segment est utilisé 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

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.

Aller-retour

Slicer : ce segment est utilisé 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

setColumnFilterCriteria(columnPosition, filterCriteria)

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

Paramètres

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

Aller-retour

Slicer : ce segment est utilisé 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

setPosition(anchorRowPos, anchorColPos, offsetX, offsetY)

Définit la position du segment sur la feuille. Les indices de position des lignes et des colonnes d'ancrage sont indexés sur 1.

Paramètres

NomTypeDescription
anchorRowPosIntegerLe dessus du segment est ancré dans cette ligne.
anchorColPosIntegerLe dessus du segment est ancré dans ce col.
offsetXIntegerDécalage horizontal par rapport à l'angle de la cellule, en pixels.
offsetYIntegerDécalage vertical en pixels de l'angle de la cellule.

Aller-retour

Slicer : ce segment est utilisé 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(rangeApi)

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

Paramètres

NomTypeDescription
rangeApiRangeNouvelle plage de ce segment.

Aller-retour

Slicer : ce segment est utilisé 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

setTitle(title)

Définit le titre du segment. Un titre vide réinitialise le titre à sa valeur par défaut.

Paramètres

NomTypeDescription
titleStringNouveau titre de ce segment.

Aller-retour

Slicer : ce segment est utilisé 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

setTitleHorizontalAlignment(horizontalAlignment)

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

Paramètres

NomTypeDescription
horizontalAlignmentStringNouvel alignement horizontal du titre de ce segment.

Aller-retour

Slicer : ce segment est utilisé 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

setTitleTextStyle(textStyle)

Définit le style de texte du segment.

Paramètres

NomTypeDescription
textStyleTextStyleNouveau style de texte du titre du segment.

Aller-retour

Slicer : ce segment est utilisé 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