Diese Seite wurde von der Cloud Translation API übersetzt.

Class EmbeddedChart

Stellt ein Diagramm dar, das in eine Tabelle 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`	Umwandlung in eine Datenquellendiagramminstanz, wenn das Diagramm ein Datenquellendiagramm ist, oder `null`.
`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 mit dem Diagramm eindeutig ist, oder `null`, wenn das Diagramm nicht in einer Tabelle enthalten ist.
`getContainerInfo()`	`ContainerInfo`	Gibt Informationen dazu zurück, wo sich das Diagramm in einem Tabellenblatt befindet.
`getHiddenDimensionStrategy()`	`ChartHiddenDimensionStrategy`	Gibt die Strategie zurück, die für die Verarbeitung ausgeblendeter Zeilen und Spalten verwendet werden soll.
`getMergeStrategy()`	`ChartMergeStrategy`	Gibt die verwendete Zusammenführungsstrategie zurück, wenn mehr als ein Bereich vorhanden ist.
`getNumHeaders()`	`Integer`	Gibt die Anzahl der Zeilen oder Spalten zurück, die als Header 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 in diesem Diagramm als Datenquelle verwendet werden.
`getTransposeRowsAndColumns()`	`Boolean`	Bei `true` werden die Zeilen und Spalten, die im Diagramm dargestellt werden, vertauscht.
`modify()`	`EmbeddedChartBuilder`	Gibt einen `EmbeddedChartBuilder` zurück, mit dem dieses Diagramm geändert werden kann.

Detaillierte Dokumentation

`asDataSourceChart()`

Umwandlung in eine Datenquellendiagramminstanz, wenn das Diagramm ein Datenquellendiagramm ist, oder null.

Zurücksenden

DataSourceChart: Das Diagramm der Datenquelle.

`getAs(contentType)`

Gibt die Daten in diesem Objekt als Blob zurück, das in den angegebenen Inhaltstyp konvertiert wurde. Mit dieser Methode wird dem Dateinamen die entsprechende Erweiterung hinzugefügt, z. B. "myfile.pdf". Es wird jedoch davon ausgegangen, dass der Teil des Dateinamens nach dem letzten Punkt (sofern vorhanden) eine vorhandene Erweiterung ist, die ersetzt werden sollte. Daher wird „"ShoppingList.12.25.2014"“ zu „"ShoppingList.12.25.pdf"“ geändert.

Informationen zum Anzeigen der täglichen Kontingente für Conversions finden Sie unter Kontingente für Google-Dienste. Für neu erstellte Google Workspace-Domains gelten möglicherweise vorübergehend strengere Kontingente.

Parameter

Name	Typ	Beschreibung
`contentType`	`String`	Der MIME-Typ, in den konvertiert werden soll. Für die meisten Blobs ist `'application/pdf'` die einzige gültige Option. Für Bilder im BMP-, GIF-, JPEG- oder PNG-Format sind außerdem `'image/bmp'`, `'image/gif'`, `'image/jpeg'` oder `'image/png'` gültig.

Zurücksenden

Blob: Die Daten als Blob.

`getBlob()`

Gibt die Daten in diesem Objekt als Blob zurück.

Zurücksenden

Blob: Die Daten als Blob.

`getChartId()`

Gibt eine stabile Kennung für das Diagramm zurück, die in der Tabelle mit dem Diagramm eindeutig ist, oder null, wenn das Diagramm nicht in einer Tabelle enthalten ist.

Zurücksenden

Integer: Eine gleichbleibende Diagramm-ID.

`getContainerInfo()`

Gibt Informationen dazu zurück, wo sich das Diagramm in einem Tabellenblatt befindet.

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());

Zurücksenden

ContainerInfo: ein Objekt mit der Position des Diagrammcontainers

`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());

Zurücksenden

ChartHiddenDimensionStrategy: Die Strategie, die für ausgeblendete Zeilen und Spalten verwendet werden soll.

`getMergeStrategy()`

Gibt die verwendete Zusammenführungsstrategie zurück, wenn mehr als ein Bereich vorhanden ist. Bei MERGE_ROWS werden die Zeilen zusammengeführt. Bei MERGE_COLUMNS werden die 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());

Zurücksenden

ChartMergeStrategy: MERGE_ROWS, wenn Zeilen in mehreren Bereichen zusammengeführt werden; MERGE_COLUMNS, wenn Spalten in mehreren Bereichen zusammengeführt werden

`getNumHeaders()`

Gibt die Anzahl der Zeilen oder Spalten zurück, die als Header 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());

Zurücksenden

Integer: Die Anzahl der Zeilen oder Spalten, die als Header behandelt werden. Negative Werte geben an, dass die Header automatisch erkannt werden.

`getOptions()`

Gibt die Optionen für dieses Diagramm zurück, z. B. Höhe, Farben und Achsen

Die zurückgegebenen Optionen sind unveränderlich.

Zurücksenden

ChartOptions: Die Optionen für dieses Diagramm, z. B. Höhe, Farben und Achsen.

`getRanges()`

Gibt die Bereiche zurück, die in diesem 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());
}

Zurücksenden

Range[]: ein Array von Bereichen, die als Datenquelle für dieses Diagramm dienen

`getTransposeRowsAndColumns()`

Bei true werden die Zeilen und Spalten, die im Diagramm dargestellt werden, 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());

Zurücksenden

Boolean: true, wenn die zum Erstellen des Diagramms verwendeten Zeilen und Spalten transponiert werden.

`modify()`

Gibt einen 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);

Zurücksenden

EmbeddedChartBuilder – ein Builder zum Erstellen eingebetteter Diagramme