Class Slicer

Datenschnitt

Stellt einen Datenschnitt dar, mit dem Bereiche, Diagramme und Pivot-Tabellen ohne Zusammenarbeit gefiltert werden können. Diese Klasse enthält Methoden, mit denen auf vorhandene Datenschnitte zugegriffen und diese geändert werden können. Verwenden Sie Sheet.insertSlicer(range, anchorRowPos, anchorColPos), um einen neuen Datenschnitt zu erstellen.

Methoden

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

Detaillierte Dokumentation

getBackgroundColorObject()

Gibt den Hintergrund-Color des Datenschnitts zurück.

Return

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

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

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

getColumnPosition()

Gibt die Spaltenposition (relativ zum Datenbereich des Datenschnitts) zurück, auf die der Filter im Datenschnitt angewendet wird, oder null, wenn keine Spaltenposition festgelegt ist. Dies sollte eine 1-indexierte Position der Spalte sein, ähnlich wie bei einem Filter.

Return

Integer: Die Spaltenposition dieses Datenschnitts.

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

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

getContainerInfo()

Ruft Informationen zur Position des Datenschnitts im Tabellenblatt ab.

Return

ContainerInfo: Ein Objekt, das die Containerposition des Datenschnitts enthält.

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

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

getFilterCriteria()

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

Return

FilterCriteria: Die Filterkriterien dieses Datenschnitts.

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

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

getRange()

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

Return

Range: Der Datenschnittbereich.

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

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

getTitle()

Gibt den Titel des Datenschnitts zurück.

Return

String: Dieser Datenschnitt wird für Verkettungen verwendet.

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

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

getTitleHorizontalAlignment()

Ruft die horizontale Ausrichtung des Titels ab.

Return

String: Die horizontale Ausrichtung des Titels dieses Datenschnitts.

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

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

getTitleTextStyle()

Gibt den Textstil des Titels des Datenschnitts zurück.

Return

TextStyle: Der Textstil des Titels dieses Datenschnitts.

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

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

isAppliedToPivotTables()

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

Return

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

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

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

remove()

Löscht den Datenschnitt.

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

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

setApplyToPivotTables(applyToPivotTables)

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

Parameter

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

Return

Slicer: Dieser Datenschnitt wird für Verkettungen verwendet.

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

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

setBackgroundColor(color)

Legt die Hintergrundfarbe des Datenschnitts fest. Durch den Wert null wird die Hintergrundfarbe zurückgesetzt.

Parameter

NameTypBeschreibung
colorStringDie neue Hintergrundfarbe dieses Datenschnitts in CSS-Notation (z. B. '#ffffff').

Return

Slicer: Dieser Datenschnitt wird für Verkettungen verwendet.

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

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

setBackgroundColorObject(color)

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

Parameter

NameTypBeschreibung
colorColorDie neue Hintergrundfarbe dieses Datenschnitts.

Return

Slicer: Dieser Datenschnitt wird für Verkettungen verwendet.

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

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

setColumnFilterCriteria(columnPosition, filterCriteria)

Legt den Spaltenindex und die Filterkriterien des Datenschnitts fest. Der Wert null setzt den Datenschnittfilter zurück.

Parameter

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

Return

Slicer: Dieser Datenschnitt wird für Verkettungen verwendet.

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

  • 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 Datenschnitt auf dem Tabellenblatt angezeigt wird. Die Positionsindexe für Ankerzeilen und -spalten sind 1indexiert.

Parameter

NameTypBeschreibung
anchorRowPosIntegerDie obere Seite des Datenschnitts ist in dieser Zeile verankert.
anchorColPosIntegerDie obere Seite des Datenschnitts ist in dieser Spalte verankert.
offsetXIntegerDer horizontale Versatz von der Ecke der Zelle in Pixeln.
offsetYIntegerVertikaler Abstand von der Zellenecke in Pixel

Return

Slicer: Dieser Datenschnitt wird für Verkettungen verwendet.

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

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

setRange(rangeApi)

Legt den Datenbereich fest, auf den der Datenschnitt angewendet wird.

Parameter

NameTypBeschreibung
rangeApiRangeDer neue Bereich für diesen Datenschnitt.

Return

Slicer: Dieser Datenschnitt wird für Verkettungen verwendet.

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

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

setTitle(title)

Legt den Titel des Datenschnitts fest. Bei einem leeren Titel wird der Titel auf den Standardwert zurückgesetzt.

Parameter

NameTypBeschreibung
titleStringDer neue Titel dieses Datenschnitts.

Return

Slicer: Dieser Datenschnitt wird für Verkettungen verwendet.

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

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

setTitleHorizontalAlignment(horizontalAlignment)

Legt die horizontale Ausrichtung des Titels im Datenschnitt fest. Der Wert null setzt die Ausrichtung zurück.

Parameter

NameTypBeschreibung
horizontalAlignmentStringDie neue horizontale Ausrichtung des Titels dieses Datenschnitts.

Return

Slicer: Dieser Datenschnitt wird für Verkettungen verwendet.

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

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

setTitleTextStyle(textStyle)

Legt den Textstil des Datenschnitts fest.

Parameter

NameTypBeschreibung
textStyleTextStyleDer neue Textstil des Titels des Datenschnitts.

Return

Slicer: Dieser Datenschnitt wird für Verkettungen verwendet.

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

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

Verworfene Methoden