Class EmbeddedTableChartBuilder

OsadzoneTabelaWykresKreator

Kreator wykresów tabelarycznych. Więcej informacji znajdziesz w dokumentacji Gviz.

Metody

MetodaZwracany typKrótki opis
addRange(range)EmbeddedChartBuilderDodaje zakres do wykresu, który modyfikuje to narzędzie.
asAreaChart()EmbeddedAreaChartBuilderUstawia typ wykresu na AreaChart i zwraca EmbeddedAreaChartBuilder.
asBarChart()EmbeddedBarChartBuilderUstawia typ wykresu na BarChart i zwraca EmbeddedBarChartBuilder.
asColumnChart()EmbeddedColumnChartBuilderUstawia typ wykresu na ColumnChart i zwraca EmbeddedColumnChartBuilder.
asComboChart()EmbeddedComboChartBuilderUstawia typ wykresu na ComboChart i zwraca EmbeddedComboChartBuilder.
asHistogramChart()EmbeddedHistogramChartBuilderUstawia typ wykresu na HistogramChart i zwraca EmbeddedHistogramChartBuilder.
asLineChart()EmbeddedLineChartBuilderUstawia typ wykresu na LineChart i zwraca EmbeddedLineChartBuilder.
asPieChart()EmbeddedPieChartBuilderUstawia typ wykresu na PieChart i zwraca EmbeddedPieChartBuilder.
asScatterChart()EmbeddedScatterChartBuilderUstawia typ wykresu na ScatterChart i zwraca EmbeddedScatterChartBuilder.
asTableChart()EmbeddedTableChartBuilderUstawia typ wykresu na TableChart i zwraca EmbeddedTableChartBuilder.
build()EmbeddedChartTworzy wykres, który odzwierciedla wszystkie wprowadzone w nim zmiany.
clearRanges()EmbeddedChartBuilderUsuwa wszystkie zakresy z wykresu, który modyfikuje ten konstruktor.
enablePaging(enablePaging)EmbeddedTableChartBuilderOkreśla, czy włączyć stronicowanie danych.
enablePaging(pageSize)EmbeddedTableChartBuilderWłącza stronicowanie i ustawia liczbę wierszy na każdej stronie.
enablePaging(pageSize, startPage)EmbeddedTableChartBuilderWłącza stronicowanie, ustawia liczbę wierszy na każdej stronie i pierwszą stronę tabeli do wyświetlenia (numery stron są oparte na zerze).
enableRtlTable(rtlEnabled)EmbeddedTableChartBuilderDodaje podstawową obsługę języków pisanych od prawej do lewej (np. arabskiego lub hebrajskiego) przez odwrócenie kolejności kolumn tabeli, tak aby kolumna zerowa była najbardziej wysunięta na prawo, a ostatnia kolumna była najbardziej wysunięta na lewo.
enableSorting(enableSorting)EmbeddedTableChartBuilderOkreśla, czy sortować kolumny, gdy użytkownik kliknie nagłówek kolumny.
getChartType()ChartTypeZwraca bieżący typ wykresu.
getContainer()ContainerInfoZwraca wykres ContainerInfo, który określa, gdzie wykres pojawia się w arkuszu.
getRanges()Range[]Zwraca kopię listy zakresów, które obecnie dostarczają dane do tego wykresu.
removeRange(range)EmbeddedChartBuilderUsuwa z wykresu, który modyfikuje ten kreator, określony zakres.
setChartType(type)EmbeddedChartBuilderZmienia typ wykresu.
setFirstRowNumber(number)EmbeddedTableChartBuilderUstawia numer wiersza pierwszego wiersza w tabeli danych.
setHiddenDimensionStrategy(strategy)EmbeddedChartBuilderOkreśla strategię, która ma być używana w przypadku ukrytych wierszy i kolumn.
setInitialSortingAscending(column)EmbeddedTableChartBuilderUstawia indeks kolumny, według której tabela ma być początkowo posortowana (w kolejności rosnącej).
setInitialSortingDescending(column)EmbeddedTableChartBuilderUstawia indeks kolumny, według której tabela powinna być początkowo posortowana (w kolejności malejącej).
setMergeStrategy(mergeStrategy)EmbeddedChartBuilderUstawia strategię scalania, która ma być używana, gdy istnieje więcej niż jeden zakres.
setNumHeaders(headers)EmbeddedChartBuilderOkreśla liczbę wierszy lub kolumn zakresu, które mają być traktowane jako nagłówki.
setOption(option, value)EmbeddedChartBuilderUstawia zaawansowane opcje tego wykresu.
setPosition(anchorRowPos, anchorColPos, offsetX, offsetY)EmbeddedChartBuilderUstawia pozycję, zmieniając miejsce, w którym wykres pojawia się w arkuszu.
setTransposeRowsAndColumns(transpose)EmbeddedChartBuilderOkreśla, czy wiersze i kolumny wykresu są transponowane.
showRowNumberColumn(showRowNumber)EmbeddedTableChartBuilderOkreśla, czy numer wiersza ma być wyświetlany jako pierwsza kolumna tabeli.
useAlternatingRowStyle(alternate)EmbeddedTableChartBuilderOkreśla, czy styl naprzemiennych kolorów jest przypisany do nieparzystych i parzystych wierszy wykresu tabeli.

Szczegółowa dokumentacja

addRange(range)

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

const ss = SpreadsheetApp.getActiveSpreadsheet(); const sheet = ss.getSheets()[0];  const chart = sheet.newChart()                   .setChartType(Charts.ChartType.BAR)                   .addRange(sheet.getRange('A1:B8'))                   .setPosition(5, 5, 0, 0)                   .build();  sheet.insertChart(chart);

Parametry

NazwaTypOpis
rangeRangeZakres do dodania.

Powrót

EmbeddedChartBuilder – ten kreator do łączenia.

asAreaChart()

Ustawia typ wykresu na AreaChart i zwraca EmbeddedAreaChartBuilder.

Powrót

EmbeddedAreaChartBuilder – narzędzie do tworzenia wykresów warstwowych.

asBarChart()

Ustawia typ wykresu na BarChart i zwraca EmbeddedBarChartBuilder.

Powrót

EmbeddedBarChartBuilder – kreator wykresu słupkowego.

asColumnChart()

Ustawia typ wykresu na ColumnChart i zwraca EmbeddedColumnChartBuilder.

Powrót

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

asComboChart()

Ustawia typ wykresu na ComboChart i zwraca EmbeddedComboChartBuilder.

Powrót

EmbeddedComboChartBuilder – kreator wykresu mieszanego.

asHistogramChart()

Ustawia typ wykresu na HistogramChart i zwraca EmbeddedHistogramChartBuilder.

Powrót

EmbeddedHistogramChartBuilder – kreator histogramu.

asLineChart()

Ustawia typ wykresu na LineChart i zwraca EmbeddedLineChartBuilder.

Powrót

EmbeddedLineChartBuilder – narzędzie do tworzenia wykresów liniowych.

asPieChart()

Ustawia typ wykresu na PieChart i zwraca EmbeddedPieChartBuilder.

Powrót

EmbeddedPieChartBuilder – kreator wykresu kołowego.

asScatterChart()

Ustawia typ wykresu na ScatterChart i zwraca EmbeddedScatterChartBuilder.

Powrót

EmbeddedScatterChartBuilder – kreator wykresów punktowych.

asTableChart()

Ustawia typ wykresu na TableChart i zwraca EmbeddedTableChartBuilder.

Powrót

EmbeddedTableChartBuilder – narzędzie do tworzenia wykresu tabeli.

build()

Tworzy wykres, który odzwierciedla wszystkie wprowadzone w nim zmiany.

Ta metoda nie powoduje automatycznego narysowania wykresu na arkuszu kalkulacyjnym. Nowy wykres musi zostać wstawiony za pomocą ikony sheet.insertChart(chart), a istniejący wykres należy zaktualizować za pomocą ikony sheet.updateChart(chart). 

const ss = SpreadsheetApp.getActiveSpreadsheet(); const sheet = ss.getSheets()[0];  const range = sheet.getRange('A1:B5'); const 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.

clearRanges()

Usuwa wszystkie zakresy z wykresu, który modyfikuje ten konstruktor. 

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

Powrót

EmbeddedChartBuilder – ten kreator do łączenia.

enablePaging(enablePaging)

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

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

Parametry

NazwaTypOpis
enablePagingBooleantrue, jeśli paginacja ma być włączona, w przeciwnym razie false.

Powrót

EmbeddedTableChartBuilder – ten konstruktor jest przydatny do łączenia.

enablePaging(pageSize)

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. const builder = Charts.newTableChart(); builder.enablePaging(5);

Parametry

NazwaTypOpis
pageSizeIntegerLiczba wierszy na każdej stronie tabeli.

Powrót

EmbeddedTableChartBuilder – ten konstruktor jest przydatny do łączenia.

enablePaging(pageSize, startPage)

Włącza stronicowanie, ustawia liczbę wierszy na każdej stronie i pierwszą stronę tabeli do wyświetlenia (numery stron są oparte na zerze).

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. const builder = Charts.newTableChart(); builder.enablePaging(5, 2);

Parametry

NazwaTypOpis
pageSizeIntegerLiczba wierszy na każdej stronie tabeli.
startPageIntegerPierwsza strona tabeli do wyświetlenia (numery stron są oparte na zerze).

Powrót

EmbeddedTableChartBuilder – ten konstruktor jest przydatny do łączenia.

enableRtlTable(rtlEnabled)

Dodaje podstawową obsługę języków pisanych od prawej do lewej (np. arabskiego lub hebrajskiego) przez odwrócenie kolejności kolumn tabeli, tak aby kolumna zerowa była najbardziej wysunięta na prawo, a ostatnia kolumna była najbardziej wysunięta na lewo.

Nie ma to wpływu na indeks kolumny w danych źródłowych, a jedynie na kolejność wyświetlania. Pełne wyświetlanie języków dwukierunkowych (BiDi) nie jest obsługiwane przez wizualizację tabeli nawet w przypadku tej opcji. Ta opcja jest ignorowana, jeśli włączysz stronicowanie (za pomocą opcji page) lub jeśli tabela ma paski przewijania, ponieważ określono opcje wysokości i szerokości mniejsze niż wymagany rozmiar tabeli. Domyślnie obsługa języków pisanych od prawej do lewej jest wyłączona.

Parametry

NazwaTypOpis
rtlEnabledBooleantrue jeśli ma być włączona obsługa języków pisanych od prawej do lewej, false w przeciwnym razie.

Powrót

EmbeddedTableChartBuilder – ten konstruktor jest przydatny do łączenia.

enableSorting(enableSorting)

Określa, czy sortować kolumny, gdy użytkownik kliknie nagłówek kolumny.

Jeśli sortowanie jest włączone, po kliknięciu nagłówka kolumny wiersze są automatycznie sortowane. Domyślnie sortowanie jest włączone.

Parametry

NazwaTypOpis
enableSortingBooleantrue, aby włączyć sortowanie przez kliknięcie nagłówków kolumn, false w przeciwnym razie.

Powrót

EmbeddedTableChartBuilder – ten konstruktor jest przydatny do łączenia.

getChartType()

Zwraca bieżący typ wykresu.

Powrót

ChartType – typ wykresu.

getContainer()

Zwraca wykres ContainerInfo, który określa, gdzie wykres pojawia się w arkuszu. 

const ss = SpreadsheetApp.getActiveSpreadsheet(); const sheet = ss.getSheets()[0];  const 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() const containerInfo = chartBuilder.getContainer();  // Logs the values 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.

getRanges()

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

const ss = SpreadsheetApp.getActiveSpreadsheet(); const sheet = ss.getSheets()[0];  const chartBuilder = sheet.newChart()                          .setChartType(Charts.ChartType.BAR)                          .addRange(sheet.getRange('A1:B8'))                          .setPosition(5, 5, 0, 0);  const ranges = chartBuilder.getRanges();  // There's only one range as a data source for this chart, // so this logs "A1:B8" for (const i in ranges) {   const range = ranges[i];   Logger.log(range.getA1Notation()); }

Powrót

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

removeRange(range)

Usuwa z wykresu, który modyfikuje ten kreator, określony zakres. Nie zgłasza błędu, jeśli zakres nie znajduje się na tym wykresie.

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

const ss = SpreadsheetApp.getActiveSpreadsheet(); const sheet = ss.getSheets()[0];  const firstRange = sheet.getRange('A1:B5'); const secondRange = sheet.getRange('A6:B8');  const chartBuilder = sheet.newChart()                          .setChartType(Charts.ChartType.BAR)                          .addRange(firstRange)                          // This range renders 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 // is not removed, and does not throw an exception chartBuilder.removeRange(firstRange); chartBuilder.removeRange(sheet.getRange('A6:B8'));  const chart = chartBuilder.build();  sheet.insertChart(chart);

Parametry

NazwaTypOpis
rangeRangeZakres do usunięcia.

Powrót

EmbeddedChartBuilder – ten kreator do łączenia.

setChartType(type)

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

const ss = SpreadsheetApp.getActiveSpreadsheet(); const sheet = ss.getSheets()[0];  const range = sheet.getRange('A1:B5'); const chart = sheet.newChart()                   .setChartType(Charts.ChartType.BAR)                   .addRange(range)                   .setPosition(5, 5, 0, 0)                   .build();  sheet.insertChart(chart);

Parametry

NazwaTypOpis
typeChartTypeTyp, na który chcesz zmienić ten wykres.

Powrót

EmbeddedChartBuilder – ten kreator do łączenia.

setFirstRowNumber(number)

Ustawia numer wiersza 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. const builder = Charts.newTableChart(); builder.setFirstRowNumber(2);

Parametry

NazwaTypOpis
numberIntegerNumer pierwszego wiersza w tabeli danych.

Powrót

EmbeddedTableChartBuilder – ten konstruktor jest przydatny do łączenia.

setHiddenDimensionStrategy(strategy)

Określa strategię, która ma być używana w przypadku ukrytych wierszy i kolumn. Domyślna wartość to IGNORE_ROWS. 

const ss = SpreadsheetApp.getActiveSpreadsheet(); const sheet = ss.getSheets()[0];  const range = sheet.getRange('A1:B5'); const chart = sheet.newChart()                   .setChartType(Charts.ChartType.BAR)                   .addRange(range)                   .setHiddenDimensionStrategy(                       Charts.ChartHiddenDimensionStrategy.IGNORE_COLUMNS,                       )                   .setPosition(5, 5, 0, 0)                   .build();  sheet.insertChart(chart);

Parametry

NazwaTypOpis
strategyChartHiddenDimensionStrategyStrategia, która ma być używana w przypadku ukrytych wierszy i kolumn.

Powrót

EmbeddedChartBuilder – ten kreator do łączenia.

setInitialSortingAscending(column)

Ustawia indeks kolumny, według której tabela ma być początkowo posortowana (w kolejności rosnącej).

Kolumna jest posortowana w kolejności rosnącej i jest oznaczona małą strzałką. 

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

Parametry

NazwaTypOpis
columnIntegerNumer kolumny, według której tabela ma być początkowo posortowana.

Powrót

EmbeddedTableChartBuilder – ten konstruktor jest przydatny do łączenia.

setInitialSortingDescending(column)

Ustawia indeks kolumny, według której tabela powinna być początkowo posortowana (w kolejności malejącej).

Kolumna jest posortowana malejąco i jest oznaczona małą strzałką. 

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

Parametry

NazwaTypOpis
columnIntegerNumer kolumny, według której tabela ma być początkowo posortowana.

Powrót

EmbeddedTableChartBuilder – ten konstruktor jest przydatny do łączenia.

setMergeStrategy(mergeStrategy)

Ustawia strategię scalania, która ma być używana, gdy istnieje więcej niż jeden zakres. Jeśli MERGE_ROWS, wiersze są scalane; jeśli MERGE_COLUMNS, kolumny są scalane. Domyślna wartość to MERGE_COLUMNS. 

const ss = SpreadsheetApp.getActiveSpreadsheet(); const sheet = ss.getSheets()[0];  const range = sheet.getRange('A1:B10'); const range2 = sheet.getRange('C:C10'); const 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

NazwaTypOpis
mergeStrategyChartMergeStrategyStrategia łączenia, której chcesz użyć.

Powrót

EmbeddedChartBuilder – ten kreator do łączenia.

setNumHeaders(headers)

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

const ss = SpreadsheetApp.getActiveSpreadsheet(); const sheet = ss.getSheets()[0];  const range = sheet.getRange('A1:B5'); const chart = sheet.newChart()                   .setChartType(Charts.ChartType.BAR)                   .addRange(range)                   .setNumHeaders(1)                   .setPosition(5, 5, 0, 0)                   .build();  sheet.insertChart(chart);

Parametry

NazwaTypOpis
headersIntegerLiczba wierszy lub kolumn, które mają być traktowane jako nagłówki. Wartości ujemne powodują automatyczne wykrywanie nagłówków.

Powrót

EmbeddedChartBuilder – ten kreator do łączenia.

setOption(option, value)

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

Ta metoda nie sprawdza, czy podana opcja jest prawidłowa w przypadku tego typu wykresu ani czy wartość ma prawidłowy format lub strukturę.

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

const spreadsheet = SpreadsheetApp.getActiveSpreadsheet(); const sheet = spreadsheet.getSheets()[0]; const chart = sheet.newChart()  .setOption('title', 'Earnings projections')  .setOption('legend', {    position: 'top',    textStyle: { color: 'blue', fontSize: 16 },  }).build();

Parametry

NazwaTypOpis
optionStringNazwa opcji.
valueObjectWartość opcji.

Powrót

EmbeddedChartBuilder – ten kreator do łączenia.

setPosition(anchorRowPos, anchorColPos, offsetX, offsetY)

Ustawia pozycję, zmieniając miejsce, w którym wykres pojawia się w arkuszu. anchorRowPos i anchorColPos są indeksowane od 1. 

const ss = SpreadsheetApp.getActiveSpreadsheet(); const sheet = ss.getSheets()[0];  const range = sheet.getRange('A1:B5'); const chart = sheet.newChart()                   .setChartType(Charts.ChartType.BAR)                   .addRange(range)                   .setPosition(5, 5, 0, 0)                   .build();  sheet.insertChart(chart);

Parametry

NazwaTypOpis
anchorRowPosIntegerGórna krawędź wykresu jest zakotwiczona w tym wierszu.
anchorColPosIntegerLewa strona wykresu jest zakotwiczona w tej kolumnie.
offsetXIntegerPrawy górny róg wykresu jest przesunięty o tę liczbę pikseli.
offsetYIntegerLewy dolny róg wykresu jest przesunięty o tę liczbę pikseli.

Powrót

EmbeddedChartBuilder – ten kreator do łączenia.

setTransposeRowsAndColumns(transpose)

Określa, czy wiersze i kolumny wykresu są transponowane. Jeśli to ustawienie ma wartość true, wiersze i kolumny zostaną zamienione. Domyślna wartość to false. 

const ss = SpreadsheetApp.getActiveSpreadsheet(); const sheet = ss.getSheets()[0];  const range = sheet.getRange('A1:B5'); const chart = sheet.newChart()                   .setChartType(Charts.ChartType.BAR)                   .addRange(range)                   .setTransposeRowsAndColumns(true)                   .setPosition(5, 5, 0, 0)                   .build();  sheet.insertChart(chart);

Parametry

NazwaTypOpis
transposeBooleanJeśli true, wiersze i kolumny użyte do utworzenia wykresu są transponowane.

Powrót

EmbeddedChartBuilder – ten kreator do łączenia.

showRowNumberColumn(showRowNumber)

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

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

Parametry

NazwaTypOpis
showRowNumberBooleantrue, jeśli pierwsza kolumna tabeli ma zawierać numer wiersza, false w przeciwnym razie.

Powrót

EmbeddedTableChartBuilder – ten konstruktor jest przydatny do łączenia.

useAlternatingRowStyle(alternate)

Określa, czy styl naprzemiennych kolorów jest przypisany do nieparzystych i parzystych wierszy wykresu tabeli.

Domyślnie wiersze mają styl z naprzemiennymi kolorami.

Parametry

NazwaTypOpis
alternateBooleantrue – jeśli style kolorów mają być naprzemienne, false – w przeciwnym razie.

Powrót

EmbeddedTableChartBuilder – ten konstruktor jest przydatny do łączenia.