Ein Diagramm, das in eine Tabellenkalkulation eingebettet wurde.
In diesem Beispiel wird gezeigt, wie Sie ein vorhandenes Diagramm ändern:
var sheet = SpreadsheetApp.getActiveSheet(); var range = sheet.getRange("A2:B8") var chart = sheet.getCharts()[0]; chart = chart.modify() .addRange(range) .setOption('title', 'Updated!') .setOption('animation.duration', 500) .setPosition(2,2,0,0) .build(); sheet.updateChart(chart);
In diesem Beispiel wird gezeigt, wie Sie ein neues Diagramm erstellen:
function newChart(range, sheet) { var sheet = SpreadsheetApp.getActiveSheet(); var chartBuilder = sheet.newChart(); chartBuilder.addRange(range) .setChartType(Charts.ChartType.LINE) .setOption('title', 'My Line Chart!'); sheet.insertChart(chartBuilder.build()); }
Methoden
Methode | Rückgabetyp | Kurzbeschreibung |
---|---|---|
asDataSourceChart() | DataSourceChart | Wird in eine Datenquellendiagramminstanz umgewandelt, wenn das Diagramm ein Datenquellendiagramm ist, oder null
sonst. |
getAs(contentType) | Blob | Gibt die Daten in diesem Objekt als Blob zurück, das in den angegebenen Inhaltstyp konvertiert wurde. |
getBlob() | Blob | Gibt die Daten in diesem Objekt als Blob zurück. |
getChartId() | Integer | Gibt eine stabile Kennung für das Diagramm zurück, die in der Tabelle, die das Diagramm enthält, eindeutig ist.
Diagramm oder null , wenn sich das Diagramm nicht in einer Tabelle befindet. |
getContainerInfo() | ContainerInfo | Gibt Informationen zur Position des Diagramms in einem Tabellenblatt zurück. |
getHiddenDimensionStrategy() | ChartHiddenDimensionStrategy | Gibt die Strategie zurück, die für die Verarbeitung ausgeblendeter Zeilen und Spalten verwendet werden soll |
getMergeStrategy() | ChartMergeStrategy | Gibt die Zusammenführungsstrategie zurück, die verwendet wird, wenn mehr als ein Bereich vorhanden ist. |
getNumHeaders() | Integer | Gibt die Anzahl der Zeilen oder Spalten des Bereichs zurück, die als Kopfzeilen behandelt werden. |
getOptions() | ChartOptions | Gibt die Optionen für dieses Diagramm zurück, z. B. Höhe, Farben und Achsen. |
getRanges() | Range[] | Gibt die Bereiche zurück, die für dieses Diagramm als Datenquelle verwendet werden. |
getTransposeRowsAndColumns() | Boolean | Bei true werden die zum Füllen des Diagramms verwendeten Zeilen und Spalten vertauscht. |
modify() | EmbeddedChartBuilder | Gibt ein EmbeddedChartBuilder zurück, mit dem dieses Diagramm geändert werden kann. |
Detaillierte Dokumentation
asDataSourceChart()
Wird in eine Datenquellendiagramminstanz umgewandelt, wenn das Diagramm ein Datenquellendiagramm ist, oder null
sonst.
Rückflug
DataSourceChart
: Das Datenquellendiagramm.
getAs(contentType)
Gibt die Daten in diesem Objekt als Blob zurück, das in den angegebenen Inhaltstyp konvertiert wurde. Dieses fügt dem Dateinamen die entsprechende Erweiterung hinzu, beispielsweise "meinedatei.pdf". Allerdings geht davon aus, dass der Teil des Dateinamens, der auf den letzten Punkt folgt (falls vorhanden), ein vorhandener die ersetzt werden soll. Daher lautet „Einkaufsliste.12.25.2014“. wird zu „Einkaufsliste.12.25.pdf“.
Die Tageskontingente für Conversions finden Sie unter Kontingente für Google Dienste. Neu erstellte Google Workspace-Domains unterliegen möglicherweise vorübergehend strengeren Richtlinien. Kontingenten.
Parameter
Name | Typ | Beschreibung |
---|---|---|
contentType | String | Der MIME-Typ, in den konvertiert werden soll. Für die meisten Blobs ist 'application/pdf'
ist die einzige gültige Option. Für Bilder im BMP-, GIF-, JPEG- oder PNG-Format gilt auch Folgendes: 'image/bmp' , 'image/gif' , 'image/jpeg' oder 'image/png'
gültig sein. Bei einem Google Docs-Dokument ist 'text/markdown' ebenfalls gültig. |
Rückflug
Blob
: Die Daten als Blob.
getBlob()
getChartId()
Gibt eine stabile Kennung für das Diagramm zurück, die in der Tabelle, die das Diagramm enthält, eindeutig ist.
Diagramm oder null
, wenn sich das Diagramm nicht in einer Tabelle befindet.
Rückflug
Integer
: Eine stabile Diagramm-ID.
getContainerInfo()
Gibt Informationen zur Position des Diagramms in einem Tabellenblatt zurück.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var chart = sheet.newChart() .setChartType(Charts.ChartType.BAR) .addRange(sheet.getRange("A1:B8")) .setPosition(5, 5, 0, 0) .build(); var containerInfo = chart.getContainerInfo(); // Logs the values we 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
ContainerInfo
– ein Objekt, das die Position des Diagrammcontainers enthält
getHiddenDimensionStrategy()
Gibt die Strategie zurück, die für die Verarbeitung ausgeblendeter Zeilen und Spalten verwendet werden soll Die Standardeinstellung ist IGNORE_ROWS
.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var range = sheet.getRange("A1:B5"); var chart = sheet.newChart() .setChartType(Charts.ChartType.BAR) .addRange(range) .setHiddenDimensionStrategy(Charts.ChartHiddenDimensionStrategy.IGNORE_COLUMNS) .setPosition(5, 5, 0, 0) .build() // Logs the strategy to use for hidden rows and columns which is // Charts.ChartHiddenDimensionStrategy.IGNORE_COLUMNS in this case. Logger.log(chart.getHiddenDimensionStrategy());
Rückflug
ChartHiddenDimensionStrategy
: Strategie für ausgeblendete Zeilen und Spalten.
getMergeStrategy()
Gibt die Zusammenführungsstrategie zurück, die verwendet wird, wenn mehr als ein Bereich vorhanden ist. Bei MERGE_ROWS
werden die Zeilen zusammengeführt. bei MERGE_COLUMNS
werden Spalten zusammengeführt. Die Standardeinstellung ist MERGE_COLUMNS
.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var range = sheet.getRange("A1:B10"); var range2 = sheet.getRange("C1:C10"); var chart = sheet.newChart() .setChartType(Charts.ChartType.BAR) .addRange(range) .addRange(range2) .setMergeStrategy(Charts.ChartMergeStrategy.MERGE_ROWS) .setPosition(5, 5, 0, 0) .build() // Logs whether rows of multiple ranges are merged, which is MERGE_ROWS in this case. Logger.log(chart.getMergeStrategy());
Rückflug
ChartMergeStrategy
: MERGE_ROWS
, wenn Zeilen über mehrere hinweg zusammengeführt werden
Bereiche MERGE_COLUMNS
, wenn Spalten zusammengeführt werden
in mehreren Bereichen
getNumHeaders()
Gibt die Anzahl der Zeilen oder Spalten des Bereichs zurück, die als Kopfzeilen behandelt werden.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var range = sheet.getRange("A1:B5"); var chart = sheet.newChart() .setChartType(Charts.ChartType.BAR) .addRange(range) .setNumHeaders(1) .setPosition(5, 5, 0, 0) .build() // Logs the number of rows or columns to use as headers, which is 1 in this case. Logger.log(chart.getHeaders());
Rückflug
Integer
: Die Anzahl der Zeilen oder Spalten, die als Kopfzeile behandelt werden. Negative Werte kennzeichnen die Überschriften
werden automatisch erkannt.
getOptions()
Gibt die Optionen für dieses Diagramm zurück, z. B. Höhe, Farben und Achsen.
Die zurückgegebenen Optionen sind unveränderlich.
Rückflug
ChartOptions
: Die Optionen für dieses Diagramm, z. B. Höhe, Farben und Achsen.
getRanges()
Gibt die Bereiche zurück, die für dieses Diagramm als Datenquelle verwendet werden.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var chart = sheet.newChart() .setChartType(Charts.ChartType.BAR) .addRange(sheet.getRange("A1:B8")) .setPosition(5, 5, 0, 0) .build(); var ranges = chart.getRanges(); // There's only one range as a data source for this chart, // so this logs "A1:B8" for (var i in ranges) { var range = ranges[i]; Logger.log(range.getA1Notation()); }
Rückflug
Range[]
: ein Array von Bereichen, die als Datenquelle dieses Diagramms dienen
getTransposeRowsAndColumns()
Bei true
werden die zum Füllen des Diagramms verwendeten Zeilen und Spalten vertauscht. Die Standardeinstellung ist false
.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var range = sheet.getRange("A1:B5"); var chart = sheet.newChart() .addRange(range) .setChartType(Charts.ChartType.BAR) .setTransposeRowsAndColumns(true) .setPosition(5, 5, 0, 0) .build() // Logs whether rows and columns should be transposed, which is true in this case. Logger.log(chart.getTransposeRowsAndColumns());
Rückflug
Boolean
: true
, wenn die zum Erstellen des Diagramms verwendeten Zeilen und Spalten transponiert werden.
modify()
Gibt ein EmbeddedChartBuilder
zurück, mit dem dieses Diagramm geändert werden kann. Rufen Sie sheet.updateChart(chart)
auf, um die Änderungen zu speichern.
var sheet = SpreadsheetApp.getActiveSheet(); var chart = sheet.getCharts()[0]; chart = chart.modify() .setOption('width', 800) .setOption('height', 640) .setPosition(5, 5, 0, 0) .build(); sheet.updateChart(chart);
Rückflug
EmbeddedChartBuilder
– ein Builder zum Erstellen eingebetteter Diagramme