Class EmbeddedChartBuilder

Dodaje zakres do wykresu, które zmieni to narzędzie. Nie dodaje zakresu, jeśli został już dodany do wykresu.

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

Parametry

Powroty

EmbeddedChartBuilder – ten kreator do tworzenia łańcuchów

Ustawia typ wykresu na Wykres warstwowy i zwraca wartość EmbeddedAreaChartBuilder.

Powroty

EmbeddedAreaChartBuilder – kreator wykresów warstwowych

Ustawia typ wykresu na Wykres słupkowy i zwraca EmbeddedBarChartBuilder.

Powroty

EmbeddedBarChartBuilder – kreator wykresów słupkowych

Ustawia typ wykresu na Wykres kolumnowy i zwraca wartość EmbeddedColumnChartBuilder.

Powroty

EmbeddedColumnChartBuilder – kreator wykresów kolumnowych

Ustawia typ wykresu na Wykres mieszany i zwraca wartość EmbeddedComboChartBuilder.

Powroty

EmbeddedComboChartBuilder – kreator wykresów mieszanych

Ustawia typ wykresu na HistogramChart i zwraca wartość EmbeddedHistogramChartBuilder.

Powroty

EmbeddedHistogramChartBuilder – narzędzie do tworzenia histogramu

Ustawia typ wykresu na Wykres liniowy i zwraca EmbeddedLineChartBuilder.

Powroty

EmbeddedLineChartBuilder – kreator wykresów liniowych.

Ustawia typ wykresu na Wykres kołowy i zwraca wartość EmbeddedPieChartBuilder.

Powroty

EmbeddedPieChartBuilder – narzędzie do tworzenia wykresu kołowego

Ustawia typ wykresu na Wykres rozproszony i zwraca wartość EmbeddedScatterChartBuilder.

Powroty

EmbeddedScatterChartBuilder – kreator wykresów punktowych

Ustawia typ wykresu na Wykres tabelaryczny i zwraca wartość EmbeddedTableChartBuilder.

Powroty

EmbeddedTableChartBuilder – kreator wykresów tabelarycznych

Tworzy wykres, aby odzwierciedlić wszystkie wprowadzone na nim zmiany.

W ten sposób wykres nie zostanie automatycznie rysowany na arkuszu kalkulacyjnym. Nowy wykres należy wstawić za pomocą sheet.insertChart(chart), a istniejący wykres należy zaktualizować przy użyciu 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);

Powroty

EmbeddedChart – utworzony wykres, który trzeba jeszcze dodać do arkusza kalkulacyjnego

Usuwa wszystkie zakresy z wykresu zmienionego przez ten konstruktor.

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

Powroty

EmbeddedChartBuilder – ten kreator do tworzenia łańcuchów

Zwraca bieżący typ wykresu.

Powroty

ChartType – typ wykresu,

Zwróć wykres ContainerInfo, który zawiera miejsce na wykresie w arkuszu.

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

Powroty

ContainerInfo – obiekt zawierający pozycję kontenera wykresu.

Zwraca kopię listy zakresów, które obecnie dostarczają dane do tego wykresu. Użyj addRange(range) i removeRange(range), by zmienić tę listę.

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

Powroty

Range[] – tablica zakresów, które służą jako źródło danych wykresu przeznaczonego do utworzenia.

Usuwa określony zakres z wykresu, które zmieni ten kreator. Nie generuje błędu, jeśli zakresu nie ma na tym wykresie.

Usunięty zakres musi odpowiadać zakresowi dodanemu za pomocą funkcji addRange(range). W przeciwnym razie na wykresie nie zostaną wprowadzone żadne zmiany. Tej metody nie można używać do częściowego usuwania wartości z zakresu.

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

Parametry

Powroty

EmbeddedChartBuilder – ten kreator do tworzenia łańcuchów

Zmienia typ wykresu. Nie wszystkie typy umieszczonych wykresów są obecnie obsługiwane. Zobacz ChartType.

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

Parametry

Powroty

EmbeddedChartBuilder – ten kreator do tworzenia łańcuchów

Ustawia strategię, która ma być używana w przypadku ukrytych wierszy i kolumn. Domyślna wartość to 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);

Parametry

Powroty

EmbeddedChartBuilder – ten kreator do tworzenia łańcuchów

Ustawia strategię scalania, która ma być używana w przypadku, gdy istnieje więcej niż jeden zakres. Jeśli ustawiona jest wartość MERGE_ROWS, wiersze są scalone, a jeśli ma wartość MERGE_COLUMNS, kolumny są scalane. Domyślna wartość to 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);

Parametry

Powroty

EmbeddedChartBuilder – ten kreator do tworzenia łańcuchów

Ustawia liczbę wierszy lub kolumn zakresu, które mają być traktowane jako nagłówki.

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

Parametry

Powroty

EmbeddedChartBuilder – ten kreator do tworzenia łańcuchów

Ustawia zaawansowane opcje wykresu. Listę dostępnych opcji znajdziesz w artykule Opcje konfiguracji wykresu.

Ta metoda nie sprawdza poprawności podanej opcji dla tego typu wykresu lub tego, czy wartość ma prawidłowy format/strukturę.

Ten przykład pokazuje, jak zmienić tytuł i ustawić legendę.

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

Parametry

Powroty

EmbeddedChartBuilder – kreator do tworzenia łańcuchów.

Ustawia położenie, zmieniając miejsce, w którym wykres ma się pojawić w arkuszu. Indeks anchorRowPos i anchorColPos mają wartość 1.

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

Parametry

Powroty

EmbeddedChartBuilder – ten kreator do tworzenia łańcuchów

Określa, czy wiersze i kolumny wykresu są transponowane. Jeśli ma wartość true, wiersze i kolumny się przełączają. Domyślna wartość to 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);

Parametry

Powroty

EmbeddedChartBuilder – ten kreator do tworzenia łańcuchów