Diese Seite wurde von der Cloud Translation API übersetzt.

Class Slicer

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

Methode	Rückgabetyp	Kurzbeschreibung
`getBackgroundColorObject()`	`Color`	Gibt den Hintergrund-`Color` des Datenschnitts zurück.
`getColumnPosition()`	`Integer`	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.
`getContainerInfo()`	`ContainerInfo`	Ruft Informationen zur Position des Datenschnitts im Tabellenblatt ab.
`getFilterCriteria()`	`FilterCriteria`	Gibt die Filterkriterien des Datenschnitts zurück oder `null`, wenn die Filterkriterien nicht festgelegt sind.
`getRange()`	`Range`	Ruft den Datenbereich ab, auf den der Datenschnitt angewendet wird.
`getTitle()`	`String`	Gibt den Titel des Datenschnitts zurück.
`getTitleHorizontalAlignment()`	`String`	Ruft die horizontale Ausrichtung des Titels ab.
`getTitleTextStyle()`	`TextStyle`	Gibt den Textstil des Titels des Datenschnitts zurück.
`isAppliedToPivotTables()`	`Boolean`	Gibt zurück, ob der angegebene Datenschnitt auf Pivot-Tabellen angewendet wird.
`remove()`	`void`	Löscht den Datenschnitt.
`setApplyToPivotTables(applyToPivotTables)`	`Slicer`	Legt fest, ob der angegebene Datenschnitt auf Pivot-Tabellen im Arbeitsblatt angewendet werden soll.
`setBackgroundColor(color)`	`Slicer`	Legt die Hintergrundfarbe des Datenschnitts fest.
`setBackgroundColorObject(color)`	`Slicer`	Legt den Hintergrund-`Color` des Datenschnitts fest.
`setColumnFilterCriteria(columnPosition, filterCriteria)`	`Slicer`	Legt den Spaltenindex und die Filterkriterien des Datenschnitts fest.
`setPosition(anchorRowPos, anchorColPos, offsetX, offsetY)`	`Slicer`	Legt die Position fest, an der der Datenschnitt auf dem Tabellenblatt angezeigt wird.
`setRange(rangeApi)`	`Slicer`	Legt den Datenbereich fest, auf den der Datenschnitt angewendet wird.
`setTitle(title)`	`Slicer`	Legt den Titel des Datenschnitts fest.
`setTitleHorizontalAlignment(horizontalAlignment)`	`Slicer`	Legt die horizontale Ausrichtung des Titels im Datenschnitt fest.
`setTitleTextStyle(textStyle)`	`Slicer`	Legt den Textstil des Datenschnitts fest.

Verworfene Methoden

Methode	Rückgabetyp	Kurzbeschreibung
`getBackgroundColor()`	`String`	Gibt die Hintergrundfarbe des Datenschnitts in CSS-Notation zurück (z. B. '#ffffff').

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

Name	Typ	Beschreibung
`applyToPivotTables`	`Boolean`	Gibt 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

Name	Typ	Beschreibung
`color`	`String`	Die 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

Name	Typ	Beschreibung
`color`	`Color`	Die 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

Name	Typ	Beschreibung
`columnPosition`	`Integer`	Die neue Spaltenposition dieses Datenschnitts.
`filterCriteria`	`FilterCriteria`	Die 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

Name	Typ	Beschreibung
`anchorRowPos`	`Integer`	Die obere Seite des Datenschnitts ist in dieser Zeile verankert.
`anchorColPos`	`Integer`	Die obere Seite des Datenschnitts ist in dieser Spalte verankert.
`offsetX`	`Integer`	Der horizontale Versatz von der Ecke der Zelle in Pixeln.
`offsetY`	`Integer`	Vertikaler 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

Name	Typ	Beschreibung
`rangeApi`	`Range`	Der 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

Name	Typ	Beschreibung
`title`	`String`	Der 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

Name	Typ	Beschreibung
`horizontalAlignment`	`String`	Die 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

Name	Typ	Beschreibung
`textStyle`	`TextStyle`	Der 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

`getBackgroundColor()`

Veraltet. Ersetzt durch getBackgroundColorObject()

Gibt die Hintergrundfarbe des Datenschnitts in CSS-Notation zurück (z. B. '#ffffff').

Return

String: 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