Class Slicer

Slicer

Stellt einen Datenschnitt dar, der zum nicht kollaborativen Filtern von Bereichen, Diagrammen und Pivot-Tabellen verwendet wird. Diese Klasse enthält Methoden zum Zugreifen auf vorhandene Slicer und zum Ändern dieser Slicer. Verwenden Sie Sheet.insertSlicer(range, anchorRowPos, anchorColPos), um einen neuen Slicer zu erstellen.

Methoden

MethodeRückgabetypKurzbeschreibung
getBackgroundColorObject()Color|nullGibt den Hintergrund Color des Slicers zurück.
getColumnPosition()Integer|nullGibt die Spaltenposition (relativ zum Datenbereich des Slicers) zurück, auf die der Filter im Slicer angewendet wird, oder null, wenn die Spaltenposition nicht festgelegt ist.
getContainerInfo()ContainerInfoRuft Informationen dazu ab, wo sich der Slicer im Tabellenblatt befindet.
getFilterCriteria()FilterCriteria|nullGibt die Filterkriterien des Slicers zurück oder null, wenn die Filterkriterien nicht festgelegt sind.
getRange()RangeRuft den Datenbereich ab, auf den der Slicer angewendet wird.
getTitle()StringGibt den Titel des Slicers zurück.
getTitleHorizontalAlignment()StringRuft die horizontale Ausrichtung des Titels ab.
getTitleTextStyle()TextStyleGibt den Textstil des Slicertitels zurück.
isAppliedToPivotTables()BooleanGibt zurück, ob der angegebene Slicer auf Pivot-Tabellen angewendet wird.
remove()voidLöscht den Datenschnitt.
setApplyToPivotTables(applyToPivotTables)SlicerLegt fest, ob der angegebene Slicer auf Pivot-Tabellen im Arbeitsblatt angewendet werden soll.
setBackgroundColor(color)SlicerLegt die Hintergrundfarbe des Slicers fest.
setBackgroundColorObject(color)SlicerLegt den Hintergrund Color des Slicers fest.
setColumnFilterCriteria(columnPosition, filterCriteria)SlicerLegt den Spaltenindex und die Filterkriterien des Slicers fest.
setPosition(anchorRowPos, anchorColPos, offsetX, offsetY)SlicerLegt die Position fest, an der der Slicer im Tabellenblatt angezeigt wird.
setRange(rangeApi)SlicerLegt den Zeitraum fest, auf den der Slicer angewendet wird.
setTitle(title)SlicerLegt den Titel des Slicers fest.
setTitleHorizontalAlignment(horizontalAlignment)SlicerHiermit wird die horizontale Ausrichtung des Titels im Slicer festgelegt.
setTitleTextStyle(textStyle)SlicerLegt den Textstil des Slicers fest.

Detaillierte Dokumentation

getBackgroundColorObject()

Gibt den Hintergrund Color des Slicers zurück.

Rückflug

Color|null: Die Hintergrundfarbe dieses Slicers. Gibt null zurück, wenn keine Farbe festgelegt ist.

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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

getColumnPosition()

Gibt die Spaltenposition (relativ zum Datenbereich des Slicers) zurück, auf die der Filter im Slicer angewendet wird, oder null, wenn die Spaltenposition nicht festgelegt ist. Dies sollte die 1-basierte Position der Spalte sein, ähnlich wie beim Filter.

Rückflug

Integer|null: Die Spaltenposition dieses Slicers.

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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

getContainerInfo()

Ruft Informationen dazu ab, wo sich der Slicer im Tabellenblatt befindet.

Rückflug

ContainerInfo: Ein Objekt mit der Containerposition des Slicers.

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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

getFilterCriteria()

Gibt die Filterkriterien des Slicers zurück oder null, wenn die Filterkriterien nicht festgelegt sind.

Rückflug

FilterCriteria|null: Die Filterkriterien dieses Slicers.

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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

getRange()

Ruft den Datenbereich ab, auf den der Slicer angewendet wird.

Rückflug

Range – Der Datenschnittbereich.

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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

getTitle()

Gibt den Titel des Slicers zurück.

Rückflug

String: Dieser Slicer zur Verkettung.

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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

getTitleHorizontalAlignment()

Ruft die horizontale Ausrichtung des Titels ab.

Rückflug

String: Die horizontale Ausrichtung des Titels dieses Slicers.

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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

getTitleTextStyle()

Gibt den Textstil des Slicertitels zurück.

Rückflug

TextStyle: Der Textstil des Titels dieses Slicers.

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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

isAppliedToPivotTables()

Gibt zurück, ob der angegebene Slicer auf Pivot-Tabellen angewendet wird.

Rückflug

Boolean: true, wenn dieser Slicer auf Pivot-Tabellen angewendet wird, andernfalls false.

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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

remove()

Löscht den Datenschnitt.

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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

setApplyToPivotTables(applyToPivotTables)

Legt fest, ob der angegebene Slicer auf Pivot-Tabellen im Arbeitsblatt angewendet werden soll.

Parameter

NameTypBeschreibung
applyToPivotTablesBooleanGibt an, ob dieser Slicer auf Pivot-Tabellen angewendet werden soll.

Rückflug

Slicer: Dieser Slicer zur Verkettung.

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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

setBackgroundColor(color)

Legt die Hintergrundfarbe des Slicers fest. Ein null-Wert setzt die Hintergrundfarbe zurück.

Parameter

NameTypBeschreibung
colorStringDie neue Hintergrundfarbe dieses Slicers in CSS-Notation (z. B. „#ffffff“).

Rückflug

Slicer: Dieser Slicer zur Verkettung.

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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

setBackgroundColorObject(color)

Legt den Hintergrund Color des Slicers fest. Ein null-Wert setzt die Hintergrundfarbe zurück.

Parameter

NameTypBeschreibung
colorColorDie neue Hintergrundfarbe dieses Slicers.

Rückflug

Slicer: Dieser Slicer zur Verkettung.

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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

setColumnFilterCriteria(columnPosition, filterCriteria)

Legt den Spaltenindex und die Filterkriterien des Slicers fest. Ein null-Wert setzt den Slicer-Filter zurück.

Parameter

NameTypBeschreibung
columnPositionIntegerDie neue Spaltenposition dieses Slicers.
filterCriteriaFilterCriteriaDie neuen Filterkriterien dieses Slicers.

Rückflug

Slicer: Dieser Slicer zur Verkettung.

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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

setPosition(anchorRowPos, anchorColPos, offsetX, offsetY)

Legt die Position fest, an der der Slicer im Tabellenblatt angezeigt wird. Die Indexe für die Ankerzeile und ‑spalte sind 1-basiert.

Parameter

NameTypBeschreibung
anchorRowPosIntegerDie Oberseite des Slicers ist in dieser Zeile verankert.
anchorColPosIntegerDie Oberseite des Slicers ist in dieser Spalte verankert.
offsetXIntegerDer horizontale Offset von der Zellenecke in Pixeln.
offsetYIntegerDer vertikale Offset von der Zellenecke in Pixeln.

Rückflug

Slicer: Dieser Slicer zur Verkettung.

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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

setRange(rangeApi)

Legt den Zeitraum fest, auf den der Slicer angewendet wird.

Parameter

NameTypBeschreibung
rangeApiRangeDer neue Bereich für diesen Slicer.

Rückflug

Slicer: Dieser Slicer zur Verkettung.

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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

setTitle(title)

Legt den Titel des Slicers fest. Wenn Sie keinen Titel angeben, wird der Titel auf den Standardwert zurückgesetzt.

Parameter

NameTypBeschreibung
titleStringDer neue Titel dieses Slicers.

Rückflug

Slicer: Dieser Slicer zur Verkettung.

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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

setTitleHorizontalAlignment(horizontalAlignment)

Hiermit wird die horizontale Ausrichtung des Titels im Slicer festgelegt. Ein null-Wert setzt die Ausrichtung zurück.

Parameter

NameTypBeschreibung
horizontalAlignmentStringDie neue horizontale Ausrichtung des Titels dieses Slicers.

Rückflug

Slicer: Dieser Slicer zur Verkettung.

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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

setTitleTextStyle(textStyle)

Legt den Textstil des Slicers fest.

Parameter

NameTypBeschreibung
textStyleTextStyleDer neue Textstil des Slicertitels.

Rückflug

Slicer: Dieser Slicer zur Verkettung.

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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

Eingestellte Methoden