Class EmbeddedChart

EmbeddedChart

Stellt ein Diagramm dar, 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

MethodeRückgabetypKurzbeschreibung
asDataSourceChart()DataSourceChartWird in eine Diagramminstanz einer Datenquelle umgewandelt, wenn das Diagramm ein Datenquellendiagramm ist. Andernfalls wird der Modus null verwendet.
getAs(contentType)BlobGibt die Daten in diesem Objekt als Blob zurück, das in den angegebenen Inhaltstyp konvertiert wurde.
getBlob()BlobGibt die Daten in diesem Objekt als Blob zurück.
getChartId()IntegerGibt eine stabile Kennung für das Diagramm zurück, die in der Tabelle eindeutig ist, die das Diagramm enthält, oder null, wenn sich das Diagramm nicht in einer Tabelle befindet.
getContainerInfo()ContainerInfoGibt Informationen zur Position des Diagramms in einem Tabellenblatt zurück.
getHiddenDimensionStrategy()ChartHiddenDimensionStrategyGibt die Strategie zurück, die für die Verarbeitung ausgeblendeter Zeilen und Spalten verwendet werden soll.
getMergeStrategy()ChartMergeStrategyGibt die Zusammenführungsstrategie zurück, die verwendet wird, wenn mehrere Bereiche vorhanden sind.
getNumHeaders()IntegerGibt die Anzahl der Zeilen oder Spalten im Bereich zurück, die als Kopfzeilen behandelt werden.
getOptions()ChartOptionsGibt die Optionen für das 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()BooleanBei true werden die Zeilen und Spalten, die zum Füllen des Diagramms verwendet werden, vertauscht.
modify()EmbeddedChartBuilderGibt ein EmbeddedChartBuilder zurück, mit dem dieses Diagramm geändert werden kann.

Detaillierte Dokumentation

asDataSourceChart()

Wird in eine Diagramminstanz einer Datenquelle umgewandelt, wenn das Diagramm ein Datenquellendiagramm ist. Andernfalls wird der Modus null verwendet.

Return

DataSourceChart: Das Datenquellendiagramm.


getAs(contentType)

Gibt die Daten in diesem Objekt als Blob zurück, das in den angegebenen Inhaltstyp konvertiert wurde. Bei dieser Methode wird dem Dateinamen die entsprechende Erweiterung hinzugefügt, z. B. "myfile.pdf". Dabei wird jedoch davon ausgegangen, dass der Teil des Dateinamens, der auf den letzten Punkt (falls vorhanden) folgt, eine vorhandene Erweiterung ist, die ersetzt werden sollte. Aus „ShoppingList.12.25.2014“ wird dann „ShoppingList.12.25.pdf“.

Informationen zu den Tageskontingenten 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

NameTypBeschreibung
contentTypeStringDer 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 auch 'image/bmp', 'image/gif', 'image/jpeg' oder 'image/png' gültig.

Return

Blob: Die Daten als Blob.


getBlob()

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

Return

Blob: Die Daten als Blob.


getChartId()

Gibt eine stabile Kennung für das Diagramm zurück, die in der Tabelle eindeutig ist, die das Diagramm enthält, oder null, wenn sich das Diagramm nicht in einer Tabelle befindet.

Return

Integer: Eine stabile Diagrammkennung.


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

Return

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

Return

ChartHiddenDimensionStrategy: Die für ausgeblendete Zeilen und Spalten zu verwendende Strategie.


getMergeStrategy()

Gibt die Zusammenführungsstrategie zurück, die verwendet wird, wenn mehrere Bereiche vorhanden sind. Bei MERGE_ROWS werden Zeilen zusammengeführt, bei MERGE_COLUMNS Spalten werden 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());

Return

ChartMergeStrategy: MERGE_ROWS, wenn Zeilen über mehrere Bereiche hinweg zusammengeführt werden; MERGE_COLUMNS, wenn Spalten über mehrere Bereiche hinweg zusammengeführt werden


getNumHeaders()

Gibt die Anzahl der Zeilen oder Spalten im Bereich 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());

Return

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


getOptions()

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

Die zurückgegebenen Optionen sind unveränderlich.

Return

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

Return

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


getTransposeRowsAndColumns()

Bei true werden die Zeilen und Spalten, die zum Füllen des Diagramms verwendet 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());

Return

Boolean: true, wenn die Zeilen und Spalten, die zum Erstellen des Diagramms verwendet wurden, 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);

Return

EmbeddedChartBuilder – ein Builder zum Erstellen eingebetteter Diagramme