Tool zum Erstellen von Tabellendiagrammen. Weitere Informationen finden Sie in der Gviz-Dokumentation.
Methoden
Methode | Rückgabetyp | Kurzbeschreibung |
---|---|---|
add | Embedded | Fügt dem Diagramm, das dieser Builder ändert, einen Bereich hinzu. |
as | Embedded | Legt den Diagrammtyp auf „Flächendiagramm“ fest und gibt eine Embedded zurück. |
as | Embedded | Legt den Diagrammtyp auf „BarChart“ fest und gibt eine Embedded zurück. |
as | Embedded | Legt den Diagrammtyp auf „ColumnChart“ fest und gibt eine Embedded zurück. |
as | Embedded | Legt den Diagrammtyp auf „Kombinationsdiagramm“ fest und gibt eine Embedded zurück. |
as | Embedded | Legt den Diagrammtyp auf „Histogrammdiagramm“ fest und gibt eine Embedded zurück. |
as | Embedded | Legt den Diagrammtyp auf „LineChart“ fest und gibt eine Embedded zurück. |
as | Embedded | Legt den Diagrammtyp auf „PieChart“ fest und gibt eine Embedded zurück. |
as | Embedded | Legt den Diagrammtyp auf „ScatterChart“ fest und gibt eine Embedded zurück. |
as | Embedded | Legt den Diagrammtyp auf „Tabellendiagramm“ fest und gibt eine Embedded zurück. |
build() | Embedded | Das Diagramm wird so erstellt, dass alle an ihm vorgenommenen Änderungen berücksichtigt werden. |
clear | Embedded | Entfernt alle Bereiche aus dem Diagramm, das mit diesem Tool geändert wird. |
enable | Embedded | Hier legen Sie fest, ob die Daten geblättert werden können. |
enable | Embedded | Hiermit wird die Paginierung aktiviert und die Anzahl der Zeilen auf jeder Seite festgelegt. |
enable | Embedded | Hiermit wird die Paginierung aktiviert. Außerdem wird die Anzahl der Zeilen auf jeder Seite und die erste Seite der Tabelle festgelegt (Seitennummern beginnen bei null). |
enable | Embedded | Es wird eine grundlegende Unterstützung für rechtsläufige Sprachen wie Arabisch oder Hebräisch hinzugefügt, indem die Spaltenreihenfolge der Tabelle umgekehrt wird, sodass Spalte 0 die äußerste rechte Spalte und die letzte Spalte die äußerste linke Spalte ist. |
enable | Embedded | Hiermit wird festgelegt, ob Spalten sortiert werden, wenn der Nutzer auf eine Spaltenüberschrift klickt. |
get | Chart | Gibt den aktuellen Diagrammtyp zurück. |
get | Container | Gibt das Diagramm Container zurück, das angibt, wo das Diagramm auf dem Tabellenblatt angezeigt wird. |
get | Range[] | Gibt eine Kopie der Liste der Bereiche zurück, die derzeit Daten für dieses Diagramm liefern. |
remove | Embedded | Entfernt den angegebenen Bereich aus dem Diagramm, das mit diesem Builder geändert wird. |
set | Embedded | Ändert den Diagrammtyp. |
set | Embedded | Legt die Zeilennummer für die erste Zeile in der Datentabelle fest. |
set | Embedded | Legt die Strategie fest, die für ausgeblendete Zeilen und Spalten verwendet werden soll. |
set | Embedded | Legt den Index der Spalte fest, nach der die Tabelle zuerst sortiert werden soll (aufsteigend). |
set | Embedded | Legt den Index der Spalte fest, nach der die Tabelle zuerst sortiert werden soll (absteigend). |
set | Embedded | Legt die Zusammenführungsstrategie fest, die verwendet werden soll, wenn mehrere Bereiche vorhanden sind. |
set | Embedded | Legt die Anzahl der Zeilen oder Spalten des Bereichs fest, die als Überschriften behandelt werden sollen. |
set | Embedded | Hier legen Sie erweiterte Optionen für dieses Diagramm fest. |
set | Embedded | Hiermit wird die Position festgelegt, an der das Diagramm auf dem Tabellenblatt angezeigt wird. |
set | Embedded | Hiermit wird festgelegt, ob die Zeilen und Spalten des Diagramms transponiert werden. |
show | Embedded | Hiermit wird festgelegt, ob die Zeilennummer als erste Spalte der Tabelle angezeigt werden soll. |
use | Embedded | Hier legen Sie fest, ob ungeraden und geraden Zeilen eines Tabellendiagramms ein abwechselnder Farbstil zugewiesen wird. |
Detaillierte Dokumentation
add Range(range)
Fügt dem Diagramm, das dieser Builder ändert, einen Bereich hinzu. Der Bereich wird nicht hinzugefügt, wenn er dem Diagramm bereits hinzugefügt wurde.
const ss = SpreadsheetApp.getActiveSpreadsheet(); const sheet = ss.getSheets()[0]; const chart = sheet.newChart() .setChartType(Charts.ChartType.BAR) .addRange(sheet.getRange('A1:B8')) .setPosition(5, 5, 0, 0) .build(); sheet.insertChart(chart);
Parameter
Name | Typ | Beschreibung |
---|---|---|
range | Range | Der Bereich, der hinzugefügt werden soll. |
Rückflug
Embedded
– dieser Builder, zur Verkettung
as Area Chart()
Legt den Diagrammtyp auf „Flächendiagramm“ fest und gibt eine Embedded
zurück.
Rückflug
Embedded
– ein Builder für ein Flächendiagramm
as Bar Chart()
Legt den Diagrammtyp auf „BarChart“ fest und gibt eine Embedded
zurück.
Rückflug
Embedded
– ein Builder für ein Balkendiagramm
as Column Chart()
Legt den Diagrammtyp auf „ColumnChart“ fest und gibt eine Embedded
zurück.
Rückflug
Embedded
– ein Builder für ein Säulendiagramm
as Combo Chart()
Legt den Diagrammtyp auf „Kombinationsdiagramm“ fest und gibt eine Embedded
zurück.
Rückflug
Embedded
– ein Builder für ein Kombinationsdiagramm
as Histogram Chart()
Legt den Diagrammtyp auf „Histogrammdiagramm“ fest und gibt eine Embedded
zurück.
Rückflug
Embedded
– ein Builder für ein Histogrammdiagramm
as Line Chart()
Legt den Diagrammtyp auf „LineChart“ fest und gibt eine Embedded
zurück.
Rückflug
Embedded
– ein Builder für ein Liniendiagramm
as Pie Chart()
Legt den Diagrammtyp auf „PieChart“ fest und gibt eine Embedded
zurück.
Rückflug
Embedded
– ein Builder für ein Kreisdiagramm
as Scatter Chart()
Legt den Diagrammtyp auf „ScatterChart“ fest und gibt eine Embedded
zurück.
Rückflug
Embedded
– ein Builder für ein Streudiagramm
as Table Chart()
Legt den Diagrammtyp auf „Tabellendiagramm“ fest und gibt eine Embedded
zurück.
Rückflug
Embedded
– ein Builder für ein Tabellendiagramm
build()
Das Diagramm wird so erstellt, dass alle an ihm vorgenommenen Änderungen berücksichtigt werden.
Bei dieser Methode wird das Diagramm nicht automatisch über der Tabelle gezeichnet. Ein neues Diagramm muss über sheet.insertChart(chart)
eingefügt und ein vorhandenes Diagramm über sheet.updateChart(chart)
aktualisiert werden.
const ss = SpreadsheetApp.getActiveSpreadsheet(); const sheet = ss.getSheets()[0]; const range = sheet.getRange('A1:B5'); const chart = sheet.newChart() .setChartType(Charts.ChartType.BAR) .addRange(range) .setPosition(5, 5, 0, 0) .build(); sheet.insertChart(chart);
Rückflug
Embedded
– das erstellte Diagramm, das der Tabelle noch hinzugefügt werden muss
clear Ranges()
Entfernt alle Bereiche aus dem Diagramm, das mit diesem Tool geändert wird.
const ss = SpreadsheetApp.getActiveSpreadsheet(); const sheet = ss.getSheets()[0]; // This code updates the chart to use only the new ranges while preserving the // existing formatting of the chart. const chart = sheet.getCharts()[0]; const newChart = chart.modify() .clearRanges() .addRange(sheet.getRange('A1:A5')) .addRange(sheet.getRange('B1:B5')) .build(); sheet.updateChart(newChart);
Rückflug
Embedded
– dieser Builder, zur Verkettung
enable Paging(enablePaging)
Hier legen Sie fest, ob die Daten geblättert werden können.
Standardmäßig ist das Auslagern deaktiviert. Wenn die Paginierung aktiviert ist, ist die Standardseitengröße 10.
Parameter
Name | Typ | Beschreibung |
---|---|---|
enable | Boolean | true , wenn die Auslagerung aktiviert werden soll, false andernfalls. |
Rückflug
Embedded
– Dieser Builder eignet sich für die Verkettung.
enable Paging(pageSize)
Hiermit wird die Paginierung aktiviert und die Anzahl der Zeilen auf jeder Seite festgelegt.
Die Standardseitengröße ist 10.
// Creates a table chart builder and enables paging with page size of 5. const builder = Charts.newTableChart(); builder.enablePaging(5);
Parameter
Name | Typ | Beschreibung |
---|---|---|
page | Integer | Die Anzahl der Zeilen auf jeder Seite der Tabelle. |
Rückflug
Embedded
– Dieser Builder eignet sich für die Verkettung.
enable Paging(pageSize, startPage)
Hiermit wird die Paginierung aktiviert. Außerdem wird die Anzahl der Zeilen auf jeder Seite und die erste Seite der Tabelle festgelegt (Seitennummern beginnen bei null).
Die Standardseitengröße ist 10 und die Standardstartseite ist 0.
// Creates a table chart builder and enables paging with page size of 5 and // displays page 2 first. const builder = Charts.newTableChart(); builder.enablePaging(5, 2);
Parameter
Name | Typ | Beschreibung |
---|---|---|
page | Integer | Die Anzahl der Zeilen auf jeder Seite der Tabelle. |
start | Integer | Die erste Tabelleseite, die angezeigt werden soll (Seitennummern beginnen bei null). |
Rückflug
Embedded
– Dieser Builder eignet sich für die Verkettung.
enable Rtl Table(rtlEnabled)
Es wird eine grundlegende Unterstützung für rechtsläufige Sprachen wie Arabisch oder Hebräisch hinzugefügt, indem die Spaltenreihenfolge der Tabelle umgekehrt wird, sodass Spalte 0 die äußerste rechte Spalte und die letzte Spalte die äußerste linke Spalte ist.
Dies wirkt sich nicht auf den Spaltenindex in den zugrunde liegenden Daten aus, sondern nur auf die Reihenfolge der Anzeige. Die vollständige bidirektionale (BiDi) Sprachanzeige wird von der Tabellenvisualisierung auch mit dieser Option nicht unterstützt. Diese Option wird ignoriert, wenn Sie die Seitenfunktion (über die Option „Seite“) aktivieren oder die Tabelle Scrollbalken hat, weil Sie für Höhe und Breite Optionen angegeben haben, die kleiner als die erforderliche Tabellengröße sind. Standardmäßig ist die Unterstützung für die RTL-Schriftrichtung deaktiviert.
Parameter
Name | Typ | Beschreibung |
---|---|---|
rtl | Boolean | true , wenn die Unterstützung für die Schriftrichtung von rechts nach links aktiviert werden soll, false andernfalls. |
Rückflug
Embedded
– Dieser Builder eignet sich für die Verkettung.
enable Sorting(enableSorting)
Hiermit wird festgelegt, ob Spalten sortiert werden, wenn der Nutzer auf eine Spaltenüberschrift klickt.
Wenn die Sortierung aktiviert ist, werden die Zeilen automatisch sortiert, wenn Nutzer auf die Spaltenüberschrift klicken. Standardmäßig ist die Sortierung aktiviert.
Parameter
Name | Typ | Beschreibung |
---|---|---|
enable | Boolean | true , um das Sortieren durch Klicken auf Spaltenüberschriften zu aktivieren, false andernfalls. |
Rückflug
Embedded
– Dieser Builder eignet sich für die Verkettung.
get Chart Type()
get Container()
Gibt das Diagramm Container
zurück, das angibt, wo das Diagramm auf dem Tabellenblatt angezeigt wird.
const ss = SpreadsheetApp.getActiveSpreadsheet(); const sheet = ss.getSheets()[0]; const chartBuilder = sheet.newChart() .setChartType(Charts.ChartType.BAR) .addRange(sheet.getRange('A1:B8')) .setPosition(5, 5, 0, 0); // This method returns the exact same data as Chart#getContainerInfo() const containerInfo = chartBuilder.getContainer(); // Logs the values used in setPosition() Logger.log( 'Anchor Column: %s\r\nAnchor Row %s\r\nOffset X %s\r\nOffset Y %s', containerInfo.getAnchorColumn(), containerInfo.getAnchorRow(), containerInfo.getOffsetX(), containerInfo.getOffsetY(), );
Rückflug
Container
: ein Objekt mit der Position des Diagrammcontainers
get Ranges()
Gibt eine Kopie der Liste der Bereiche zurück, die derzeit Daten für dieses Diagramm liefern. Verwenden Sie add
und remove
, um diese Liste zu ändern.
const ss = SpreadsheetApp.getActiveSpreadsheet(); const sheet = ss.getSheets()[0]; const chartBuilder = sheet.newChart() .setChartType(Charts.ChartType.BAR) .addRange(sheet.getRange('A1:B8')) .setPosition(5, 5, 0, 0); const ranges = chartBuilder.getRanges(); // There's only one range as a data source for this chart, // so this logs "A1:B8" for (const i in ranges) { const range = ranges[i]; Logger.log(range.getA1Notation()); }
Rückflug
Range[]
: ein Array von Bereichen, die als Datenquelle für das zu erstellende Diagramm dienen
remove Range(range)
Entfernt den angegebenen Bereich aus dem Diagramm, das mit diesem Builder geändert wird. Es wird kein Fehler ausgegeben, wenn der Bereich nicht in diesem Diagramm enthalten ist.
Der entfernte Bereich muss mit einem Bereich übereinstimmen, der über add
hinzugefügt wurde. Andernfalls wird das Diagramm nicht geändert. Mit dieser Methode können keine Werte teilweise aus einem Bereich entfernt werden.
const ss = SpreadsheetApp.getActiveSpreadsheet(); const sheet = ss.getSheets()[0]; const firstRange = sheet.getRange('A1:B5'); const secondRange = sheet.getRange('A6:B8'); const chartBuilder = sheet.newChart() .setChartType(Charts.ChartType.BAR) .addRange(firstRange) // This range will render in a different color .addRange(secondRange) .setPosition(5, 5, 0, 0); // Note that you can use either of these two formats, but the range // MUST match up with a range that was added via addRange(), or it // will not be removed, and will not throw an exception chartBuilder.removeRange(firstRange); chartBuilder.removeRange(sheet.getRange('A6:B8')); const chart = chartBuilder.build(); sheet.insertChart(chart);
Parameter
Name | Typ | Beschreibung |
---|---|---|
range | Range | Der Bereich, der entfernt werden soll. |
Rückflug
Embedded
– dieser Builder, zur Verkettung
set Chart Type(type)
Ändert den Diagrammtyp. Derzeit werden nicht alle eingebetteten Diagrammtypen unterstützt. Chart
ansehen.
const ss = SpreadsheetApp.getActiveSpreadsheet(); const sheet = ss.getSheets()[0]; const range = sheet.getRange('A1:B5'); const chart = sheet.newChart() .setChartType(Charts.ChartType.BAR) .addRange(range) .setPosition(5, 5, 0, 0) .build(); sheet.insertChart(chart);
Parameter
Name | Typ | Beschreibung |
---|---|---|
type | Chart | Der Typ, in den dieses Diagramm umgewandelt werden soll. |
Rückflug
Embedded
– dieser Builder, zur Verkettung
set First Row Number(number)
Legt die Zeilennummer für die erste Zeile in der Datentabelle fest.
Die Standardzeilennummer der ersten Zeile ist 1.
// Creates a table chart builder and sets the first row to be 2. const builder = Charts.newTableChart(); builder.setFirstRowNumber(2);
Parameter
Name | Typ | Beschreibung |
---|---|---|
number | Integer | Die Zeilennummer der ersten Zeile in der Datentabelle. |
Rückflug
Embedded
– Dieser Builder eignet sich für die Verkettung.
set Hidden Dimension Strategy(strategy)
Legt die Strategie fest, die für ausgeblendete Zeilen und Spalten verwendet werden soll. Die Standardeinstellung ist IGNORE_ROWS
.
const ss = SpreadsheetApp.getActiveSpreadsheet(); const sheet = ss.getSheets()[0]; const range = sheet.getRange('A1:B5'); const chart = sheet.newChart() .setChartType(Charts.ChartType.BAR) .addRange(range) .setHiddenDimensionStrategy( Charts.ChartHiddenDimensionStrategy.IGNORE_COLUMNS, ) .setPosition(5, 5, 0, 0) .build(); sheet.insertChart(chart);
Parameter
Name | Typ | Beschreibung |
---|---|---|
strategy | Chart | Die Strategie, die für ausgeblendete Zeilen und Spalten verwendet werden soll. |
Rückflug
Embedded
– dieser Builder, zur Verkettung
set Initial Sorting Ascending(column)
Legt den Index der Spalte fest, nach der die Tabelle zuerst sortiert werden soll (aufsteigend).
Die Spalte ist in aufsteigender Reihenfolge sortiert und wird durch einen kleinen Pfeil gekennzeichnet.
// Creates a table chart builder and sorts it by the second column (ascending). const builder = Charts.newTableChart(); builder.setInitialSortingAscending(2);
Parameter
Name | Typ | Beschreibung |
---|---|---|
column | Integer | Die Nummer der Spalte, nach der die Tabelle zuerst sortiert werden soll. |
Rückflug
Embedded
– Dieser Builder eignet sich für die Verkettung.
set Initial Sorting Descending(column)
Legt den Index der Spalte fest, nach der die Tabelle zuerst sortiert werden soll (absteigend).
Die Spalte ist in absteigender Reihenfolge sortiert und wird durch einen kleinen Pfeil gekennzeichnet.
// Creates a table chart builder and sorts it by the second column (descending). const builder = Charts.newTableChart(); builder.setInitialSortingDescending(2);
Parameter
Name | Typ | Beschreibung |
---|---|---|
column | Integer | Die Nummer der Spalte, nach der die Tabelle zuerst sortiert werden soll. |
Rückflug
Embedded
– Dieser Builder eignet sich für die Verkettung.
set Merge Strategy(mergeStrategy)
Legt die Zusammenführungsstrategie fest, die verwendet werden soll, wenn mehrere Bereiche vorhanden sind. Bei MERGE_ROWS
werden Zeilen zusammengeführt, bei MERGE_COLUMNS
Spalten. Die Standardeinstellung ist MERGE_COLUMNS
.
const ss = SpreadsheetApp.getActiveSpreadsheet(); const sheet = ss.getSheets()[0]; const range = sheet.getRange('A1:B10'); const range2 = sheet.getRange('C:C10'); const chart = sheet.newChart() .setChartType(Charts.ChartType.BAR) .addRange(range) .addRange(range2) .setMergeStrategy(Charts.ChartMergeStrategy.MERGE_ROWS) .setPosition(5, 5, 0, 0) .build(); sheet.insertChart(chart);
Parameter
Name | Typ | Beschreibung |
---|---|---|
merge | Chart | Die zu verwendende Zusammenführungsstrategie. |
Rückflug
Embedded
– dieser Builder, zur Verkettung
set Num Headers(headers)
Legt die Anzahl der Zeilen oder Spalten des Bereichs fest, die als Überschriften behandelt werden sollen.
const ss = SpreadsheetApp.getActiveSpreadsheet(); const sheet = ss.getSheets()[0]; const range = sheet.getRange('A1:B5'); const chart = sheet.newChart() .setChartType(Charts.ChartType.BAR) .addRange(range) .setNumHeaders(1) .setPosition(5, 5, 0, 0) .build(); sheet.insertChart(chart);
Parameter
Name | Typ | Beschreibung |
---|---|---|
headers | Integer | Die Anzahl der Zeilen oder Spalten, die als Überschriften behandelt werden sollen. Bei negativen Werten werden Überschriften automatisch erkannt. |
Rückflug
Embedded
– dieser Builder, zur Verkettung
set Option(option, value)
Hier legen Sie erweiterte Optionen für dieses Diagramm fest. Eine Liste der verfügbaren Optionen finden Sie unter Diagrammkonfigurationsoptionen.
Bei dieser Methode wird nicht geprüft, ob die angegebene Option für diesen Diagrammtyp gültig ist oder ob der Wert das richtige Format bzw. die richtige Struktur hat.
In diesem Beispiel wird gezeigt, wie Sie den Titel ändern und eine Legende festlegen.
const spreadsheet = SpreadsheetApp.getActiveSpreadsheet(); const sheet = spreadsheet.getSheets()[0]; const chart = sheet.newChart() .setOption('title', 'Earnings projections') .setOption('legend', { position: 'top', textStyle: { color: 'blue', fontSize: 16 }, }).build();
Parameter
Name | Typ | Beschreibung |
---|---|---|
option | String | Der Name der Option. |
value | Object | Der Wert der Option. |
Rückflug
Embedded
– Dieser Builder zur Verkettung.
set Position(anchorRowPos, anchorColPos, offsetX, offsetY)
Hiermit wird die Position festgelegt, an der das Diagramm auf dem Tabellenblatt angezeigt wird. anchor
und anchor
beginnen mit 1.
const ss = SpreadsheetApp.getActiveSpreadsheet(); const sheet = ss.getSheets()[0]; const range = sheet.getRange('A1:B5'); const chart = sheet.newChart() .setChartType(Charts.ChartType.BAR) .addRange(range) .setPosition(5, 5, 0, 0) .build(); sheet.insertChart(chart);
Parameter
Name | Typ | Beschreibung |
---|---|---|
anchor | Integer | Die Oberseite des Diagramms ist in dieser Zeile verankert. |
anchor | Integer | Die linke Seite des Diagramms ist in dieser Spalte verankert. |
offsetX | Integer | Die rechte obere Ecke des Diagramms wird um diese Anzahl von Pixeln verschoben. |
offsetY | Integer | Die linke untere Ecke des Diagramms wird um diese Anzahl von Pixeln verschoben. |
Rückflug
Embedded
– dieser Builder, zur Verkettung
set Transpose Rows And Columns(transpose)
Hiermit wird festgelegt, ob die Zeilen und Spalten des Diagramms transponiert werden. Wenn true
festgelegt ist, werden die Zeilen und Spalten vertauscht. Die Standardeinstellung ist false
.
const ss = SpreadsheetApp.getActiveSpreadsheet(); const sheet = ss.getSheets()[0]; const range = sheet.getRange('A1:B5'); const chart = sheet.newChart() .setChartType(Charts.ChartType.BAR) .addRange(range) .setTransposeRowsAndColumns(true) .setPosition(5, 5, 0, 0) .build(); sheet.insertChart(chart);
Parameter
Name | Typ | Beschreibung |
---|---|---|
transpose | Boolean | Bei true werden die Zeilen und Spalten, die zum Erstellen des Diagramms verwendet werden, transponiert. |
Rückflug
Embedded
– dieser Builder, zur Verkettung
show Row Number Column(showRowNumber)
Hiermit wird festgelegt, ob die Zeilennummer als erste Spalte der Tabelle angezeigt werden soll.
Standardmäßig werden keine Zeilennummern angezeigt.
Parameter
Name | Typ | Beschreibung |
---|---|---|
show | Boolean | true , wenn die erste Spalte der Tabelle die Zeilennummer enthalten soll, false andernfalls. |
Rückflug
Embedded
– Dieser Builder eignet sich für die Verkettung.
use Alternating Row Style(alternate)
Hier legen Sie fest, ob ungeraden und geraden Zeilen eines Tabellendiagramms ein abwechselnder Farbstil zugewiesen wird.
Standardmäßig haben die Zeilen einen abwechselnden Farbstil.
Parameter
Name | Typ | Beschreibung |
---|---|---|
alternate | Boolean | true , wenn die Farbstile abwechselnd verwendet werden sollen, false andernfalls. |
Rückflug
Embedded
– Dieser Builder eignet sich für die Verkettung.