Class EmbeddedTableChartBuilder

Fügt dem Diagramm einen Bereich hinzu, den dieser Builder ändert. Der Bereich wird nicht hinzugefügt, wenn er bereits wurden dem Diagramm hinzugefügt.

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

sheet.insertChart(chart);

Parameter

Rückflug

EmbeddedChartBuilder – dieser Builder für Verkettungen

Legt den Diagrammtyp auf „Flächendiagramm“ fest und gibt ein EmbeddedAreaChartBuilder zurück.

Rückflug

EmbeddedAreaChartBuilder: Ein Builder für ein Flächendiagramm

Legt den Diagrammtyp auf Balkendiagramm fest und gibt ein EmbeddedBarChartBuilder zurück.

Rückflug

EmbeddedBarChartBuilder: Ein Builder für ein Balkendiagramm

Legt den Diagrammtyp auf „ColumnChart“ fest und gibt ein EmbeddedColumnChartBuilder zurück.

Rückflug

EmbeddedColumnChartBuilder – ein Builder für ein Säulendiagramm

Legt den Diagrammtyp auf ComboChart fest und gibt ein EmbeddedComboChartBuilder zurück.

Rückflug

EmbeddedComboChartBuilder – ein Builder für ein Kombinationsdiagramm

Legt den Diagrammtyp auf „HistogramChart“ fest und gibt ein EmbeddedHistogramChartBuilder zurück.

Rückflug

EmbeddedHistogramChartBuilder – ein Builder für ein Histogrammdiagramm

Legt den Diagrammtyp auf „LineChart“ fest und gibt ein EmbeddedLineChartBuilder zurück.

Rückflug

EmbeddedLineChartBuilder: Builder für ein Liniendiagramm

Legt den Diagrammtyp auf „Kreisdiagramm“ fest und gibt ein EmbeddedPieChartBuilder zurück.

Rückflug

EmbeddedPieChartBuilder: ein Builder für ein Kreisdiagramm

Legt den Diagrammtyp auf ScatterChart fest und gibt ein EmbeddedScatterChartBuilder zurück.

Rückflug

EmbeddedScatterChartBuilder: ein Builder für ein Streudiagramm

Legt den Diagrammtyp auf „TableChart“ fest und gibt ein EmbeddedTableChartBuilder zurück.

Rückflug

EmbeddedTableChartBuilder: ein Builder für ein Tabellendiagramm

Erstellt das Diagramm so, dass alle daran vorgenommenen Änderungen widergespiegelt werden

Bei dieser Methode wird das Diagramm nicht automatisch über der Tabelle gezeichnet. Neues Diagramm muss über sheet.insertChart(chart) eingefügt werden und ein vorhandenes Diagramm sollte aktualisiert werden über sheet.updateChart(chart).

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)
    .setPosition(5, 5, 0, 0)
    .build();

sheet.insertChart(chart);

Rückflug

EmbeddedChart: das erstellte Diagramm, das der Tabelle noch hinzugefügt werden muss

Entfernt alle Bereiche aus dem Diagramm, das dieser Builder ändert.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

// This code updates the chart to use only the new ranges while preserving the existing
// formatting of the chart.
var chart = sheet.getCharts()[0];
var newChart = chart
    .modify()
    .clearRanges()
    .addRange(sheet.getRange("A1:A5"))
    .addRange(sheet.getRange("B1:B5"))
    .build();
sheet.updateChart(newChart);

Rückflug

EmbeddedChartBuilder – dieser Builder für Verkettungen

Legt fest, ob das Paging durch die Daten aktiviert werden soll.

Paging ist standardmäßig deaktiviert. Wenn Paging aktiviert ist, beträgt die Standardseitengröße 10.

Parameter

Rückflug

EmbeddedTableChartBuilder: Dieser Builder, der für Verkettungen nützlich ist.

Aktiviert das Paging und legt die Anzahl der Zeilen auf jeder Seite fest.

Die Standardseitengröße ist 10.

// Creates a table chart builder and enables paging with page size of 5.
var builder = Charts.newTableChart();
builder.enablePaging(5);

Parameter

Rückflug

EmbeddedTableChartBuilder: Dieser Builder, der für Verkettungen nützlich ist.

Aktiviert das Paging und legt die Anzahl der Zeilen auf jeder Seite sowie die erste anzuzeigende Tabellenseite (Seite) fest. Zahlen 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.
var builder = Charts.newTableChart();
builder.enablePaging(5, 2);

Parameter

Rückflug

EmbeddedTableChartBuilder: Dieser Builder, der für Verkettungen nützlich ist.

Durch die Umkehrung von linksläufigen Sprachen wie Arabisch oder Hebräisch werden linksläufige Sprachen unterstützt. Spaltenreihenfolge der Tabelle, sodass Spalte 0 die Spalte ganz rechts und die letzte Spalte der Spalte ganz links.

Dies wirkt sich nicht auf den Spaltenindex in den zugrunde liegenden Daten aus, sondern nur auf die Anzeigereihenfolge. Die vollständige bidirektionale Sprachanzeige (BiDi) wird von der Tabellenvisualisierung nicht unterstützt, auch nicht mit dieser Option. Diese Option wird ignoriert, wenn Sie Paging (mithilfe der Seitenoption) aktivieren oder verfügt die Tabelle über Bildlaufleisten, da Sie Optionen für Höhe und Breite angegeben haben, die kleiner als die erforderlichen Tabellengröße. Standardmäßig ist die RTL-Unterstützung deaktiviert.

Parameter

Rückflug

EmbeddedTableChartBuilder: Dieser Builder, der für Verkettungen nützlich ist.

Legt fest, ob Spalten sortiert werden sollen, wenn der Nutzer auf eine Spaltenüberschrift klickt.

Wenn die Sortierung aktiviert ist, werden die Zeilen automatisch angezeigt, wenn Nutzende auf die Spaltenüberschrift klicken. sortiert. Die Sortierung ist standardmäßig aktiviert.

Parameter

Rückflug

EmbeddedTableChartBuilder: Dieser Builder, der für Verkettungen nützlich ist.

Gibt den aktuellen Diagrammtyp zurück.

Rückflug

ChartType – Diagrammtyp

Gibt das Diagramm ContainerInfo zurück. Es enthält die Stelle, an der das Diagramm im Tabellenblatt.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

var 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()
var containerInfo = chartBuilder.getContainer();

// 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

Gibt eine Kopie der Liste der Bereiche zurück, die derzeit Daten für dieses Diagramm bereitstellen. Verwende addRange(range) und removeRange(range), um diese Liste zu ändern.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

var chartBuilder = sheet.newChart()
    .setChartType(Charts.ChartType.BAR)
    .addRange(sheet.getRange("A1:B8"))
    .setPosition(5, 5, 0, 0);

var ranges = chartBuilder.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 für das Diagramm dienen

Entfernt den angegebenen Bereich aus dem Diagramm, das dieser Builder ändert. Gibt keinen Fehler aus, wenn der Bereich nicht im Diagramm enthalten ist.

Der entfernte Bereich muss mit einem Bereich übereinstimmen, der über addRange(range) hinzugefügt wurde. Andernfalls wird das Diagramm nicht geändert. Diese Methode kann nicht verwendet werden, um Werte teilweise zu entfernen aus einem Bereich.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

var firstRange = sheet.getRange("A1:B5");
var secondRange = sheet.getRange("A6:B8");

var 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"));

var chart = chartBuilder.build();

sheet.insertChart(chart);

Parameter

Rückflug

EmbeddedChartBuilder – dieser Builder für Verkettungen

Ändert den Diagrammtyp Derzeit werden nicht alle eingebetteten Diagrammtypen unterstützt. ChartType ansehen.

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)
    .setPosition(5, 5, 0, 0)
    .build();

sheet.insertChart(chart);

Parameter

Rückflug

EmbeddedChartBuilder – dieser Builder für Verkettungen

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.
var builder = Charts.newTableChart();
builder.setFirstRowNumber(2);

Parameter

Rückflug

EmbeddedTableChartBuilder: Dieser Builder, der für Verkettungen nützlich ist.

Legt die Strategie für ausgeblendete Zeilen und Spalten fest. 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();

sheet.insertChart(chart);

Parameter

Rückflug

EmbeddedChartBuilder – dieser Builder für Verkettungen

Legt den Index der Spalte fest, nach der die Tabelle anfänglich sortiert werden soll (aufsteigend).

Das Betriebssystem der Spalte ist in aufsteigender Reihenfolge sortiert und mit einem kleinen Pfeil gekennzeichnet.

// Creates a table chart builder and sorts it by the second column (ascending).
var builder = Charts.newTableChart();
builder.setInitialSortingAscending(2);

Parameter

Rückflug

EmbeddedTableChartBuilder: Dieser Builder, der für Verkettungen nützlich ist.

Legt den Index der Spalte fest, nach der die Tabelle anfänglich sortiert werden soll (absteigend).

Das Betriebssystem der Spalte ist in absteigender Reihenfolge sortiert und mit einem kleinen Pfeil gekennzeichnet.

// Creates a table chart builder and sorts it by the second column (descending).
var builder = Charts.newTableChart();
builder.setInitialSortingDescending(2);

Parameter

Rückflug

EmbeddedTableChartBuilder: Dieser Builder, der für Verkettungen nützlich ist.

Legt die Zusammenführungsstrategie fest, die verwendet werden soll, wenn mehr als ein Bereich vorhanden ist. Bei MERGE_ROWS werden 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("C:C10");
var 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

Rückflug

EmbeddedChartBuilder – dieser Builder für Verkettungen

Legt die Anzahl der Zeilen oder Spalten des Bereichs fest, die als Kopfzeilen behandelt werden sollen.

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

sheet.insertChart(chart);

Parameter

Rückflug

EmbeddedChartBuilder – dieser Builder für Verkettungen

Legt erweiterte Optionen für dieses Diagramm fest. Eine Liste der verfügbaren Optionen finden Sie unter Diagramm Konfigurationsoptionen.

Mit dieser Methode wird weder bestätigt, dass die von Ihnen angegebene Option für diesen Diagrammtyp gültig ist, noch ob der hat das richtige Format bzw. die richtige Struktur.

In diesem Beispiel wird gezeigt, wie Sie den Titel ändern und eine Legende festlegen.

builder.setOption('title', 'Earnings projections');
builder.setOption('legend', {position: 'top', textStyle: {color: 'blue', fontSize: 16}});

Parameter

Rückflug

EmbeddedChartBuilder: Dieser Builder für Verkettungen.

Legt die Position des Diagramms auf dem Tabellenblatt fest. anchorRowPos und anchorColPos sind 1-indexiert.

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)
    .setPosition(5, 5, 0, 0)
    .build();

sheet.insertChart(chart);

Parameter

Rückflug

EmbeddedChartBuilder – dieser Builder für Verkettungen

Legt fest, ob die Zeilen und Spalten des Diagramms transponiert werden. Wenn true festgelegt ist, werden die 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()
    .setChartType(Charts.ChartType.BAR)
    .addRange(range)
    .setTransposeRowsAndColumns(true)
    .setPosition(5, 5, 0, 0)
    .build();

sheet.insertChart(chart);

Parameter

Rückflug

EmbeddedChartBuilder – dieser Builder für Verkettungen

Legt fest, ob die Zeilennummer als erste Spalte der Tabelle angezeigt werden soll.

Standardmäßig werden keine Zeilennummern angezeigt.

Parameter

Rückflug

EmbeddedTableChartBuilder: Dieser Builder, der für Verkettungen nützlich ist.

Legt fest, ob den ungeraden und geraden Zeilen eines Tabellendiagramms ein abwechselnder Farbstil zugewiesen wird.

Das Standardverhalten ist, dass die Zeilen einen abwechselnden Farbstil haben.

Parameter

Rückflug

EmbeddedTableChartBuilder: Dieser Builder, der für Verkettungen nützlich ist.