Class EmbeddedChart

EmbeddedChart

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

MethodeRückgabetypKurzbeschreibung
asDataSourceChart()DataSourceChartWird in eine Datenquellendiagramminstanz umgewandelt, wenn das Diagramm ein Datenquellendiagramm ist, oder null sonst.
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, die das Diagramm enthält, eindeutig ist. Diagramm 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 mehr als ein Bereich vorhanden ist.
getNumHeaders()IntegerGibt die Anzahl der Zeilen oder Spalten des Bereichs zurück, die als Kopfzeilen behandelt werden.
getOptions()ChartOptionsGibt 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()BooleanBei true werden die zum Füllen des Diagramms verwendeten Zeilen und Spalten vertauscht.
modify()EmbeddedChartBuilderGibt 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

NameTypBeschreibung
contentTypeStringDer 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()

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

Rückflug

Blob: Die Daten als Blob.


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