Class EmbeddedTableChartBuilder

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

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

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

Parametry

Powroty

EmbeddedTableChartBuilder – kreator przydatny do tworzenia łańcuchów.

Włącza stronicowanie 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

Powroty

EmbeddedTableChartBuilder – kreator przydatny do tworzenia łańcuchów.

Włącza stronicowanie. Ustawia liczbę wierszy na każdej stronie i na pierwszej stronie tabeli (numery stron są 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

Powroty

EmbeddedTableChartBuilder – kreator przydatny do tworzenia łańcuchów.

Dodaje podstawową obsługę języków pisanych od prawej do lewej (takich jak arabski czy hebrajski) przez odwrócenie kolejności kolumn tabeli, w wyniku czego kolumna 0 jest kolumną skrajną od prawej, a ostatnia od lewej.

Nie ma to wpływu na indeks kolumn w danych bazowych, a jedynie na kolejność wyświetlania. Wizualizacja tabeli nie obsługuje wyświetlania pełnego dwukierunku (BiDi), nawet jeśli ta opcja jest włączona. Ta opcja jest ignorowana, jeśli włączysz stronicowanie (za pomocą opcji strony) lub jeśli w tabeli występują paski przewijania, ponieważ określone opcje wysokości i szerokości są mniejsze niż wymagany rozmiar tabeli. Domyślnym działaniem jest wyłączenie obsługi RTL.

Parametry

Powroty

EmbeddedTableChartBuilder – kreator przydatny do tworzenia łańcuchów.

Określa, czy kolumny mają być sortowane, gdy użytkownik kliknie nagłówek kolumny.

Jeśli sortowanie jest włączone, wiersze są automatycznie sortowane, gdy użytkownik kliknie nagłówek kolumny. Domyślnie sortowanie jest włączone.

Parametry

Powroty

EmbeddedTableChartBuilder – kreator przydatny 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 numer pierwszego wiersza w tabeli danych.

Domyślny numer 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

Powroty

EmbeddedTableChartBuilder – kreator przydatny 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 indeks kolumny, według której tabela ma być początkowo sortowana (rosnąco).

Kolumna os została 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

Powroty

EmbeddedTableChartBuilder – kreator przydatny do tworzenia łańcuchów.

Ustawia indeks kolumny, według której tabela ma być początkowo sortowana (malejąco).

Kolumna os została 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

Powroty

EmbeddedTableChartBuilder – kreator przydatny 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

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

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

Parametry

Powroty

EmbeddedTableChartBuilder – kreator przydatny do tworzenia łańcuchów.

Określa, czy zmienny styl kolorów jest przypisywany do wierszy nieparzystych i parzystych na wykresie tabelarycznym.

Domyślnym zachowaniem są wiersze ze zmiennym stylem kolorów.

Parametry

Powroty

EmbeddedTableChartBuilder – kreator przydatny do tworzenia łańcuchów.