Diese Seite wurde von der Cloud Translation API übersetzt.

Class Slicer

Stellt einen Slicer dar, mit dem Bereiche, Diagramme und Pivot-Tabellen nicht gemeinsam bearbeitet werden können. Diese Klasse enthält Methoden zum Aufrufen und Ändern vorhandener Datenschnitte. Mit Sheet.insertSlicer(range, anchorRowPos, anchorColPos) können Sie einen neuen Datenschnitt 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 die Spaltenposition nicht festgelegt ist.
`getContainerInfo()`	`ContainerInfo`	Ruft Informationen zur Positionierung des Datenschnitts im Tabellenblatt ab.
`getFilterCriteria()`	`FilterCriteria`	Gibt die Filterkriterien des Datenschnitts oder `null` zurück, 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`	Der Datenschnitt wird gelöscht.
`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 im 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.

Eingestellte 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.

Zurücksenden

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

Autorisierung

Für Skripts, die diese Methode verwenden, ist eine Autorisierung in mindestens einem der folgenden Bereiche erforderlich:

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 die Spaltenposition nicht festgelegt ist. Dies sollte eine an der Indexierung befindliche Position der Spalte sein, ähnlich wie beim Filter.

Zurücksenden

Integer: Die Spaltenposition dieses Datenschnitts.

Autorisierung

Für Skripts, die diese Methode verwenden, ist eine Autorisierung in mindestens einem der folgenden Bereiche erforderlich:

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

`getContainerInfo()`

Ruft Informationen zur Positionierung des Datenschnitts im Tabellenblatt ab.

Zurücksenden

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

Autorisierung

Für Skripts, die diese Methode verwenden, ist eine Autorisierung in mindestens einem der folgenden Bereiche erforderlich:

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

`getFilterCriteria()`

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

Zurücksenden

FilterCriteria: Die Filterkriterien dieses Datenschnitts.

Autorisierung

Für Skripts, die diese Methode verwenden, ist eine Autorisierung in mindestens einem der folgenden Bereiche erforderlich:

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

`getRange()`

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

Zurücksenden

Range: Der Datenschnittbereich.

Autorisierung

Für Skripts, die diese Methode verwenden, ist eine Autorisierung in mindestens einem der folgenden Bereiche erforderlich:

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

`getTitle()`

Gibt den Titel des Datenschnitts zurück

Zurücksenden

String: Dieser Datenschnitt zum Verketten.

Autorisierung

Für Skripts, die diese Methode verwenden, ist eine Autorisierung in mindestens einem der folgenden Bereiche erforderlich:

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

`getTitleHorizontalAlignment()`

Ruft die horizontale Ausrichtung des Titels ab.

Zurücksenden

String: Die horizontale Ausrichtung des Titels dieses Datenschnitts.

Autorisierung

Für Skripts, die diese Methode verwenden, ist eine Autorisierung in mindestens einem der folgenden Bereiche erforderlich:

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

`getTitleTextStyle()`

Gibt den Textstil des Titels des Datenschnitts zurück

Zurücksenden

TextStyle: Der Textstil des Titels dieses Datenschnitts.

Autorisierung

Für Skripts, die diese Methode verwenden, ist eine Autorisierung in mindestens einem der folgenden Bereiche erforderlich:

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.

Zurücksenden

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

Autorisierung

Für Skripts, die diese Methode verwenden, ist eine Autorisierung in mindestens einem der folgenden Bereiche erforderlich:

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

`remove()`

Der Datenschnitt wird gelöscht.

Autorisierung

Für Skripts, die diese Methode verwenden, ist eine Autorisierung in mindestens einem der folgenden Bereiche erforderlich:

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.

Zurücksenden

Slicer: Dieser Datenschnitt zum Verketten.

Autorisierung

Für Skripts, die diese Methode verwenden, ist eine Autorisierung in mindestens einem der folgenden Bereiche erforderlich:

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

`setBackgroundColor(color)`

Legt die Hintergrundfarbe des Datenschnitts fest. Mit dem Wert null wird die Hintergrundfarbe zurückgesetzt.

Parameter

Name	Typ	Beschreibung
`color`	`String`	Die neue Hintergrundfarbe dieses Datenschnitts in CSS-Notation (z. B. '#ffffff').

Zurücksenden

Slicer: Dieser Datenschnitt zum Verketten.

Autorisierung

Für Skripts, die diese Methode verwenden, ist eine Autorisierung in mindestens einem der folgenden Bereiche erforderlich:

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

`setBackgroundColorObject(color)`

Legt den Hintergrund Color des Datenschnitts fest. Mit dem Wert null wird die Hintergrundfarbe zurückgesetzt.

Parameter

Name	Typ	Beschreibung
`color`	`Color`	Die neue Hintergrundfarbe dieses Datenschnitts.

Zurücksenden

Slicer: Dieser Datenschnitt zum Verketten.

Autorisierung

Für Skripts, die diese Methode verwenden, ist eine Autorisierung in mindestens einem der folgenden Bereiche erforderlich:

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. Mit dem Wert null wird der Datenschnittfilter zurückgesetzt.

Parameter

Name	Typ	Beschreibung
`columnPosition`	`Integer`	Die neue Spaltenposition dieses Datenschnitts.
`filterCriteria`	`FilterCriteria`	Die neuen Filterkriterien dieses Datenschnitts.

Zurücksenden

Slicer: Dieser Datenschnitt zum Verketten.

Autorisierung

Für Skripts, die diese Methode verwenden, ist eine Autorisierung in mindestens einem der folgenden Bereiche erforderlich:

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 im Tabellenblatt angezeigt wird. Die Ankerzeilen- und Spaltenpositionsindexe sind 1-indexiert.

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 Zellenecke in Pixeln.
`offsetY`	`Integer`	Der vertikale Versatz von der Zellenecke in Pixeln.

Zurücksenden

Slicer: Dieser Datenschnitt zum Verketten.

Autorisierung

Für Skripts, die diese Methode verwenden, ist eine Autorisierung in mindestens einem der folgenden Bereiche erforderlich:

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.

Zurücksenden

Slicer: Dieser Datenschnitt zum Verketten.

Autorisierung

Für Skripts, die diese Methode verwenden, ist eine Autorisierung in mindestens einem der folgenden Bereiche erforderlich:

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.

Zurücksenden

Slicer: Dieser Datenschnitt zum Verketten.

Autorisierung

Für Skripts, die diese Methode verwenden, ist eine Autorisierung in mindestens einem der folgenden Bereiche erforderlich:

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

`setTitleHorizontalAlignment(horizontalAlignment)`

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

Parameter

Name	Typ	Beschreibung
`horizontalAlignment`	`String`	Die neue horizontale Ausrichtung des Titels dieses Datenschnitts.

Zurücksenden

Slicer: Dieser Datenschnitt zum Verketten.

Autorisierung

Für Skripts, die diese Methode verwenden, ist eine Autorisierung in mindestens einem der folgenden Bereiche erforderlich:

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 Datenschnitts.

Zurücksenden

Slicer: Dieser Datenschnitt zum Verketten.

Autorisierung

Für Skripts, die diese Methode verwenden, ist eine Autorisierung in mindestens einem der folgenden Bereiche erforderlich:

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

Eingestellte Methoden

`getBackgroundColor()`

Eingestellt. Ersetzt durch getBackgroundColorObject()

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

Zurücksenden

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

Autorisierung

Für Skripts, die diese Methode verwenden, ist eine Autorisierung in mindestens einem der folgenden Bereiche erforderlich:

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