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