Kreator wykresów tabelarycznych. Więcej informacji znajdziesz w dokumentacji Gviz.
Metody
| Metoda | Zwracany typ | Krótki opis |
|---|---|---|
add | Embedded | Dodaje zakres do wykresu, który modyfikuje to narzędzie. |
as | Embedded | Ustawia typ wykresu na AreaChart i zwraca Embedded. |
as | Embedded | Ustawia typ wykresu na BarChart i zwraca Embedded. |
as | Embedded | Ustawia typ wykresu na ColumnChart i zwraca Embedded. |
as | Embedded | Ustawia typ wykresu na ComboChart i zwraca Embedded. |
as | Embedded | Ustawia typ wykresu na HistogramChart i zwraca Embedded. |
as | Embedded | Ustawia typ wykresu na LineChart i zwraca Embedded. |
as | Embedded | Ustawia typ wykresu na PieChart i zwraca Embedded. |
as | Embedded | Ustawia typ wykresu na ScatterChart i zwraca Embedded. |
as | Embedded | Ustawia typ wykresu na TableChart i zwraca Embedded. |
build() | Embedded | Tworzy wykres, który odzwierciedla wszystkie wprowadzone w nim zmiany. |
clear | Embedded | Usuwa wszystkie zakresy z wykresu, który modyfikuje ten konstruktor. |
enable | Embedded | Określa, czy włączyć stronicowanie danych. |
enable | Embedded | Włącza stronicowanie i ustawia liczbę wierszy na każdej stronie. |
enable | Embedded | Włącza stronicowanie, ustawia liczbę wierszy na każdej stronie i pierwszą stronę tabeli do wyświetlenia (numery stron są oparte na zerze). |
enable | Embedded | 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. |
enable | Embedded | Określa, czy kolumny mają być sortowane, gdy użytkownik kliknie nagłówek kolumny. |
get | Chart | Zwraca bieżący typ wykresu. |
get | Container | Zwraca wykres Container, który określa, gdzie wykres pojawia się w arkuszu. |
get | Range[] | Zwraca kopię listy zakresów, które obecnie dostarczają dane do tego wykresu. |
remove | Embedded | Usuwa określony zakres z wykresu, który modyfikuje ten konstruktor. |
set | Embedded | Zmienia typ wykresu. |
set | Embedded | Ustawia numer wiersza pierwszego wiersza w tabeli danych. |
set | Embedded | Określa strategię, która ma być używana w przypadku ukrytych wierszy i kolumn. |
set | Embedded | Ustawia indeks kolumny, według której tabela ma być początkowo posortowana (rosnąco). |
set | Embedded | Ustawia indeks kolumny, według której tabela powinna być początkowo posortowana (w kolejności malejącej). |
set | Embedded | Ustawia strategię scalania, która ma być używana, gdy istnieje więcej niż jeden zakres. |
set | Embedded | Określa liczbę wierszy lub kolumn zakresu, które mają być traktowane jako nagłówki. |
set | Embedded | Ustawia zaawansowane opcje tego wykresu. |
set | Embedded | Ustawia pozycję, zmieniając miejsce, w którym wykres pojawia się w arkuszu. |
set | Embedded | Określa, czy wiersze i kolumny wykresu są transponowane. |
show | Embedded | Określa, czy numer wiersza ma być wyświetlany jako pierwsza kolumna tabeli. |
use | Embedded | Określa, czy styl kolorów naprzemiennych 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
| Nazwa | Typ | Opis |
|---|---|---|
range | Range | Zakres 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 – kreator 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 wykresu punktowego.
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ą sheet.insertChart(chart), a istniejący wykres należy zaktualizować za pomocą 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
| Nazwa | Typ | Opis |
|---|---|---|
enable | Boolean | true, 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
| Nazwa | Typ | Opis |
|---|---|---|
page | Integer | Liczba 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
| Nazwa | Typ | Opis |
|---|---|---|
page | Integer | Liczba wierszy na każdej stronie tabeli. |
start | Integer | Pierwsza 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
| Nazwa | Typ | Opis |
|---|---|---|
rtl | Boolean | true jeśli ma być włączona obsługa pisma od prawej do lewej, false
w przeciwnym razie. |
Powrót
EmbeddedTableChartBuilder – ten konstruktor jest przydatny do łączenia.
enableSorting(enableSorting)
Określa, czy kolumny mają być sortowane, 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
| Nazwa | Typ | Opis |
|---|---|---|
enable | Boolean | true, aby włączyć sortowanie przez klikanie nagłówków kolumn, false w przeciwnym razie. |
Powrót
EmbeddedTableChartBuilder – ten konstruktor jest przydatny do łączenia.
getChartType()
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 określony zakres z wykresu, który modyfikuje ten konstruktor. 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
| Nazwa | Typ | Opis |
|---|---|---|
range | Range | Zakres do usunięcia. |
Powrót
EmbeddedChartBuilder – ten kreator do łączenia.
setChartType(type)
Zmienia typ wykresu. Obecnie nie wszystkie typy wykresów osadzonych są 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
| Nazwa | Typ | Opis |
|---|---|---|
type | Chart | Typ, 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
| Nazwa | Typ | Opis |
|---|---|---|
number | Integer | Numer 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
| Nazwa | Typ | Opis |
|---|---|---|
strategy | Chart | Strategia, 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 (rosnąco).
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
| Nazwa | Typ | Opis |
|---|---|---|
column | Integer | Numer kolumny, według której tabela ma być początkowo sortowana. |
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
| Nazwa | Typ | Opis |
|---|---|---|
column | Integer | Numer kolumny, według której tabela ma być początkowo sortowana. |
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 zostaną scalone, a jeśli MERGE_COLUMNS, kolumny zostaną scalone. 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
| Nazwa | Typ | Opis |
|---|---|---|
merge | Chart | Strategia łączenia, która ma być używana. |
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
| Nazwa | Typ | Opis |
|---|---|---|
headers | Integer | Liczba 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
| Nazwa | Typ | Opis |
|---|---|---|
option | String | Nazwa opcji. |
value | Object | Wartość 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
| Nazwa | Typ | Opis |
|---|---|---|
anchor | Integer | Górna krawędź wykresu jest zakotwiczona w tym wierszu. |
anchor | Integer | Lewa strona wykresu jest zakotwiczona w tej kolumnie. |
offsetX | Integer | Prawy górny róg wykresu jest przesunięty o tę liczbę pikseli. |
offsetY | Integer | Lewy 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 ta opcja 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
| Nazwa | Typ | Opis |
|---|---|---|
transpose | Boolean | Jeś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
| Nazwa | Typ | Opis |
|---|---|---|
show | Boolean | true, 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 kolorów naprzemiennych jest przypisany do nieparzystych i parzystych wierszy wykresu tabeli.
Domyślnie wiersze mają styl z naprzemiennymi kolorami.
Parametry
| Nazwa | Typ | Opis |
|---|---|---|
alternate | Boolean | true – jeśli style kolorów mają być naprzemienne, false – w przeciwnym razie. |
Powrót
EmbeddedTableChartBuilder – ten konstruktor jest przydatny do łączenia.