Class EmbeddedTableChartBuilder

Dodaje zakres do wykresu edytowanego przez ten kreator. Nie dodaje zakresu, jeśli został już utworzony. który został 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

Powrót

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

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

Powrót

EmbeddedAreaChartBuilder – narzędzie do tworzenia wykresów warstwowych

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

Powrót

EmbeddedBarChartBuilder – narzędzie do tworzenia wykresów słupkowych

Ustawia typ wykresu na ColumnChart i zwraca EmbeddedColumnChartBuilder.

Powrót

EmbeddedColumnChartBuilder – narzędzie do tworzenia wykresów kolumnowych.

Ustawia typ wykresu na ComboChart i zwraca wartość EmbeddedComboChartBuilder.

Powrót

EmbeddedComboChartBuilder – narzędzie do tworzenia wykresów mieszanych

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

Powrót

EmbeddedHistogramChartBuilder – narzędzie do tworzenia histogramu

Ustawia typ wykresu na Wykres liniowy i zwraca wartość EmbeddedLineChartBuilder.

Powrót

EmbeddedLineChartBuilder – narzędzie do tworzenia wykresów liniowych

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

Powrót

EmbeddedPieChartBuilder – narzędzie do tworzenia wykresu kołowego

Ustawia typ wykresu na wykres punktowy i zwraca wartość EmbeddedScatterChartBuilder.

Powrót

EmbeddedScatterChartBuilder – narzędzie do tworzenia wykresu punktowego

Ustawia typ wykresu na TableChart i zwraca EmbeddedTableChartBuilder.

Powrót

EmbeddedTableChartBuilder – narzędzie do tworzenia wykresów tabelarycznych

Tworzy wykres w sposób odzwierciedlający wszystkie wprowadzone w nim zmiany.

Ta metoda nie powoduje automatycznego rysowania w arkuszu kalkulacyjnym. Nowy wykres należy wstawić za pomocą sheet.insertChart(chart), a istniejący wykres powinien zostać zaktualizowany przez: 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);

Powrót

EmbeddedChart – utworzony wykres, który należy jeszcze dodać do arkusza kalkulacyjnego.

Usuwa wszystkie zakresy z wykresu edytowanego przez ten kreator.

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

Powrót

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

Określa, czy włączyć stronicowanie danych.

Domyślnie strony są wyłączone. Jeśli włączone jest stronicowanie, domyślny rozmiar strony to 10.

Parametry

Powrót

EmbeddedTableChartBuilder – to kreator przydatny w przypadku łańcuchów.

Włącza podział na strony i ustawia liczbę wierszy na każdej stronie.

Domyślny rozmiar strony to 10.

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

Parametry

Powrót

EmbeddedTableChartBuilder – to kreator przydatny w przypadku łańcuchów.

Włącza podział na strony, ustawia liczbę wierszy na każdej stronie i pierwszą stronę tabeli do wyświetlenia (strona liczby liczone od zera).

Domyślny rozmiar strony to 10, a domyślna strona początkowa to 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);

Parametry

Powrót

EmbeddedTableChartBuilder – to kreator przydatny w przypadku łańcuchów.

Dodaje podstawową obsługę języków pisanych od prawej do lewej (takich jak arabski czy hebrajski) przez odwrócenie kolejność kolumn w tabeli, tak aby kolumna 0 była kolumną skrajnie prawą, a ostatnia kolumna była znajdujący się skrajnie po lewej stronie.

Nie ma to wpływu na indeks kolumn w danych bazowych, a jedynie na kolejność wyświetlania. Wyświetlanie w pełnym dwukierunkowym języku (BiDi) nie jest obsługiwane przez wizualizację tabeli nawet przy użyciu tej opcji. Ta opcja jest ignorowana, jeśli włączysz stronicowanie (za pomocą opcji na stronie) lub tabela zawiera paski przewijania, ponieważ określone opcje wysokości i szerokości są mniejsze niż wymagany rozmiar tabeli. Domyślnie obsługa tekstu od prawej do lewej jest wyłączona.

Parametry

Powrót

EmbeddedTableChartBuilder – to kreator przydatny w przypadku łańcuchów.

Określa, czy kolumny mają być sortowane po kliknięciu przez użytkownika nagłówka.

Jeśli włączone jest sortowanie, po kliknięciu przez użytkownika nagłówka kolumny wiersze zostaną automatycznie posortowane. Domyślnie włączone jest sortowanie.

Parametry

Powrót

EmbeddedTableChartBuilder – to kreator przydatny w przypadku łańcuchów.

Zwraca bieżący typ wykresu.

Powrót

ChartType – typ wykresu,

Zwraca wykres ContainerInfo, który zawiera informacje o tym, gdzie na wykresie arkusza kalkulacyjnego.

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

Powrót

ContainerInfo – obiekt zawierający pozycję kontenera wykresu.

Zwraca kopię listy zakresów, które obecnie dostarczają dane do tego wykresu. Użyj narzędzi addRange(range) i removeRange(range), by zmodyfikować 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());
}

Powrót

Range[] – tablica zakresów, która służy jako źródło danych do utworzenia wykresu

Usuwa określony zakres z wykresu edytowanego przez ten kreator. Nie zwraca błędu, jeśli: zakresu nie ma na tym wykresie.

Usunięty zakres musi pasować do zakresu dodanego za pomocą funkcji addRange(range); w przeciwnym razie wykres nie ulegnie zmianie. 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

Powrót

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

Zmienia typ wykresu. Nie wszystkie typy wykresów umieszczanych 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

Powrót

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

Określa numer pierwszego wiersza tabeli danych.

Domyślny numer wiersza pierwszego wiersza to 1.

// Creates a table chart builder and sets the first row to be 2.
var builder = Charts.newTableChart();
builder.setFirstRowNumber(2);

Parametry

Powrót

EmbeddedTableChartBuilder – to kreator przydatny w przypadku łańcuchów.

Określa strategię, która ma być stosowana 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

Powrót

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

Ustawia indeks kolumny, zgodnie z którym tabela ma być początkowo sortowana (rosnąco).

Kolumna System operacyjny jest posortowana w kolejności rosnącej i jest oznaczona małą strzałką, która to oznacza.

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

Parametry

Powrót

EmbeddedTableChartBuilder – to kreator przydatny w przypadku łańcuchów.

Ustawia indeks kolumny, zgodnie z którym tabela ma być początkowo sortowana (malejąco).

Kolumna System operacyjny jest posortowana w kolejności malejącej i jest oznaczona małą strzałką, która to oznacza.

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

Parametry

Powrót

EmbeddedTableChartBuilder – to kreator przydatny w przypadku łańcuchów.

Ustawia strategię scalania używaną, gdy istnieje więcej niż 1 zakres. Jeśli MERGE_ROWS, wiersze są scalane; jeśli MERGE_COLUMNS, kolumny zostaną scalone. 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

Powrót

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

Określa liczbę wierszy lub kolumn w zakresie, 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

Powrót

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

Określa zaawansowane opcje tego wykresu. Listę dostępnych opcji znajdziesz w sekcji Wykres opcje konfiguracji.

Ta metoda nie sprawdza, czy podana opcja jest odpowiednia dla tego typu wykresu ani jeśli 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

Powrót

EmbeddedChartBuilder – narzędzie do tworzenia łańcuchów.

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

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

Powrót

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

Określa, czy wiersze i kolumny wykresu mają być transponowane. Jeśli ma wartość true, wiersze i kolumny zostaną przełączone. 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

Powrót

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

Określa, czy numer wiersza ma być wyświetlany jako pierwsza kolumna tabeli.

Domyślnie numery wierszy nie są wyświetlane.

Parametry

Powrót

EmbeddedTableChartBuilder – to kreator przydatny w przypadku łańcuchów.

Określa, czy styl z naprzemiennymi kolorami jest przypisany do nieparzystych i parzystych wierszy wykresu tabelarycznego.

Domyślnie wiersze mają naprzemienne kolory.

Parametry

Powrót

EmbeddedTableChartBuilder – to kreator przydatny w przypadku łańcuchów.