Kreator wykresów słupkowych. Więcej informacji znajdziesz w dokumentacji Gviz.
Metody
Metoda | Zwracany typ | Krótki opis |
---|---|---|
add | Embedded | Dodaje zakres do wykresu modyfikowanego przez ten kreator. |
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 „Tabela” i zwraca Embedded . |
build() | Embedded | Tworzy wykres, uwzględniając wszystkie wprowadzone w nim zmiany. |
clear | Embedded | Usuwa z wykresu wszystkie zakresy, które modyfikuje ten kreator. |
enable | Embedded | Określa, czy należy włączyć przewijanie danych. |
enable | Embedded | Włącza podział na strony i ustala liczbę wierszy na stronie. |
enable | Embedded | Umożliwia podział na strony, ustawia liczbę wierszy na każdej stronie i pierwszą stronę tabeli do wyświetlenia (numery stron są liczone od zera). |
enable | Embedded | Dodaje podstawową obsługę języków zapisywanych od prawej do lewej (np. arabskiego lub hebrajskiego) przez odwrócenie kolejności kolumn tabeli, tak aby kolumna 0 była kolumną najbardziej na prawo, a ostatnia kolumna – najbardziej 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 zawiera informacje o tym, gdzie wykres jest widoczny w arkuszu. |
get | Range[] | Zwraca kopię listy zakresów, które obecnie dostarczają dane na potrzeby tego wykresu. |
remove | Embedded | Usuwa określony zakres z wykresu modyfikowanego przez ten kreator. |
set | Embedded | Zmienia typ wykresu. |
set | Embedded | Ustawia numer wiersza dla pierwszego wiersza w tabeli danych. |
set | Embedded | Określa strategię używaną w przypadku ukrytych wierszy i kolumn. |
set | Embedded | Ustawia indeks kolumny, według której tabela ma być początkowo sortowana (w kolejności rosnącej). |
set | Embedded | Ustawia indeks kolumny, według której tabela ma być początkowo sortowana (malejąco). |
set | Embedded | Określa strategię scalania, której należy użyć, gdy istnieje więcej niż 1 zakres. |
set | Embedded | Określa liczbę wierszy lub kolumn zakresu, które mają być traktowane jako nagłówki. |
set | Embedded | Ustawia zaawansowane opcje wykresu. |
set | Embedded | Ustawia położenie wykresu na arkuszu. |
set | Embedded | Określa, czy wiersze i kolumny wykresu mają być zamieniane miejscami. |
show | Embedded | Określa, czy numer wiersza ma być wyświetlany jako pierwsza kolumna tabeli. |
use | Embedded | Określa, czy styl naprzemiennych kolorów jest przypisany do nieparzystych i parzystych wierszy wykresu tabeli. |
Szczegółowa dokumentacja
add Range(range)
Dodaje zakres do wykresu modyfikowanego przez ten kreator. Nie dodaje zakresu, jeśli został on 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
Embedded
– ten kreator do łańcuchowania
as Area Chart()
Ustawia typ wykresu na AreaChart i zwraca Embedded
.
Powrót
Embedded
– kreator wykresu warstwowego
as Bar Chart()
Ustawia typ wykresu na „BarChart” i zwraca Embedded
.
Powrót
Embedded
– kreator wykresu słupkowego,
as Column Chart()
Ustawia typ wykresu na ColumnChart i zwraca Embedded
.
Powrót
Embedded
– kreator wykresu kolumnowego
as Combo Chart()
Ustawia typ wykresu na „ComboChart” i zwraca Embedded
.
Powrót
Embedded
– kreator wykresu mieszanego
as Histogram Chart()
Ustawia typ wykresu na HistogramChart i zwraca Embedded
.
Powrót
Embedded
– kreator histogramu
as Line Chart()
Ustawia typ wykresu na „LineChart” i zwraca Embedded
.
Powrót
Embedded
– kreator wykresu liniowego
as Pie Chart()
Ustawia typ wykresu na PieChart i zwraca Embedded
.
Powrót
Embedded
– kreator wykresu kołowego
as Scatter Chart()
Ustawia typ wykresu na ScatterChart i zwraca Embedded
.
Powrót
Embedded
– kreator wykresu punktowego
as Table Chart()
Ustawia typ wykresu na „Tabela” i zwraca Embedded
.
Powrót
Embedded
– kreator wykresu tabelarycznego
build()
Tworzy wykres, uwzględniając wszystkie wprowadzone w nim zmiany.
Ta metoda nie powoduje automatycznego rysowania wykresu na wierzchu arkusza kalkulacyjnego. Nowy wykres należy wstawić za pomocą sheet.insertChart(chart)
, a istniejący 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
Embedded
– utworzony wykres, który musi zostać dodany do arkusza kalkulacyjnego.
clear Ranges()
Usuwa z wykresu wszystkie zakresy, które modyfikuje ten kreator.
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
Embedded
– ten kreator do łańcuchowania
enable Paging(enablePaging)
Określa, czy należy włączyć przewijanie danych.
Domyślnie paging jest wyłączony. Jeśli masz włączone podział na strony, domyślny rozmiar strony to 10.
Parametry
Nazwa | Typ | Opis |
---|---|---|
enable | Boolean | true , jeśli ma być włączone przewijanie, a w przeciwnym razie false . |
Powrót
Embedded
– ten kreator jest przydatny do łańcuchowania.
enable Paging(pageSize)
Włącza podział na strony i ustala liczbę wierszy na 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
Embedded
– ten kreator jest przydatny do łańcuchowania.
enable Paging(pageSize, startPage)
Umożliwia podział na strony, ustawia liczbę wierszy na każdej stronie i pierwszą stronę tabeli do wyświetlenia (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. 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ą liczone od 0). |
Powrót
Embedded
– ten kreator jest przydatny do łańcuchowania.
enable Rtl Table(rtlEnabled)
Dodaje podstawową obsługę języków zapisywanych od prawej do lewej (np. arabskiego lub hebrajskiego) przez odwrócenie kolejności kolumn tabeli, tak aby kolumna 0 była kolumną najbardziej na prawo, a ostatnia kolumna – najbardziej na lewo.
Nie wpływa to na indeks kolumny w podstawowych danych, tylko na kolejność wyświetlania. Wizualizacja tabeli nie obsługuje pełnego dwukierunkowego (BiDi) wyświetlania języka, nawet z tą opcją. Ta opcja jest ignorowana, jeśli włączysz przewijanie (za pomocą opcji strony) lub jeśli tabela ma paski przewijania, ponieważ masz ustawione opcje wysokości i szerokości mniejsze niż wymagany rozmiar tabeli. Domyślnie obsługa RTL jest wyłączona.
Parametry
Nazwa | Typ | Opis |
---|---|---|
rtl | Boolean | true , jeśli ma być włączone wyświetlanie od prawej do lewej, false w przeciwnym razie. |
Powrót
Embedded
– ten kreator jest przydatny do łańcuchowania.
enable Sorting(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 umożliwić sortowanie przez klikanie nagłówków kolumn, false w przeciwnym razie. |
Powrót
Embedded
– ten kreator jest przydatny do łańcuchowania.
get Chart Type()
get Container()
Zwraca wykres Container
, który zawiera informacje o tym, gdzie wykres jest widoczny 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
Container
– obiekt zawierający położenie kontenera wykresu
get Ranges()
Zwraca kopię listy zakresów, które obecnie dostarczają dane na potrzeby tego wykresu. Aby zmodyfikować tę listę, użyj opcji add
i remove
.
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, który ma zostać utworzony
remove Range(range)
Usuwa określony zakres z wykresu modyfikowanego przez ten kreator. Nie powoduje błędu, jeśli zakres nie znajduje się na tym wykresie.
Usuwany zakres musi być zgodny z zakresem dodanym za pomocą add
. W przeciwnym razie wykres nie ulegnie zmianie. Tej metody nie można użyć 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 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')); const chart = chartBuilder.build(); sheet.insertChart(chart);
Parametry
Nazwa | Typ | Opis |
---|---|---|
range | Range | Zakres do usunięcia. |
Powrót
Embedded
– ten kreator do łańcuchowania
set Chart Type(type)
Zmienia typ wykresu. Obecnie nie wszystkie typy osadzonych wykresów są obsługiwane. Zobacz 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);
Parametry
Nazwa | Typ | Opis |
---|---|---|
type | Chart | Typ, na który chcesz zmienić ten wykres. |
Powrót
Embedded
– ten kreator do łańcuchowania
set First Row Number(number)
Ustawia numer wiersza dla 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
Embedded
– ten kreator jest przydatny do łańcuchowania.
set Hidden Dimension Strategy(strategy)
Określa strategię używaną 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 stosowana w przypadku ukrytych wierszy i kolumn. |
Powrót
Embedded
– ten kreator do łańcuchowania
set Initial Sorting Ascending(column)
Ustawia indeks kolumny, według której tabela ma być początkowo sortowana (w kolejności rosnącej).
Kolumna jest posortowana rosnąco i 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 posortowana. |
Powrót
Embedded
– ten kreator jest przydatny do łańcuchowania.
set Initial Sorting Descending(column)
Ustawia indeks kolumny, według której tabela ma być początkowo sortowana (malejąco).
Kolumna jest posortowana malejąco i 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 posortowana. |
Powrót
Embedded
– ten kreator jest przydatny do łańcuchowania.
set Merge Strategy(mergeStrategy)
Określa strategię scalania, której należy użyć, gdy istnieje więcej niż 1 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
Nazwa | Typ | Opis |
---|---|---|
merge | Chart | Strategia łączenia do użycia. |
Powrót
Embedded
– ten kreator do łańcuchowania
set Num Headers(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
Embedded
– ten kreator do łańcuchowania
set Option(option, value)
Ustawia zaawansowane opcje wykresu. Listę dostępnych opcji znajdziesz w sekcji Opcje konfiguracji wykresu.
Ta metoda nie sprawdza, czy wybrana opcja jest odpowiednia dla 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
Embedded
– ten kreator do łańcuchowania.
set Position(anchorRowPos, anchorColPos, offsetX, offsetY)
Ustawia położenie wykresu na arkuszu. Funkcje anchor
i anchor
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 przypięta do tego wiersza. |
anchor | Integer | Lewa strona wykresu jest zakotwiczona w tej kolumnie. |
offsetX | Integer | Prawy górny róg wykresu jest przesunięty o tyle pikseli. |
offsetY | Integer | Lewym dolnym rogu wykresu przesuwa się o tyle pikseli. |
Powrót
Embedded
– ten kreator do łańcuchowania
set Transpose Rows And Columns(transpose)
Określa, czy wiersze i kolumny wykresu mają być zamieniane miejscami. Jeśli ustawisz 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 stworzenia wykresu zostaną zamienione miejscami. |
Powrót
Embedded
– ten kreator do łańcuchowania
show Row Number Column(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 – false . |
Powrót
Embedded
– ten kreator jest przydatny do łańcuchowania.
use Alternating Row Style(alternate)
Określa, czy styl naprzemiennych kolorów jest przypisany do nieparzystych i parzystych wierszy wykresu tabeli.
Domyślnie wiersze mają naprzemiennie kolory.
Parametry
Nazwa | Typ | Opis |
---|---|---|
alternate | Boolean | true , jeśli style kolorów mają się naprzemiennie pojawiać, false w przeciwnym razie. |
Powrót
Embedded
– ten kreator jest przydatny do łańcuchowania.