Tworzenie 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. |
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. |
reverse | Embedded | Odwraca kolejność rysowania serii na osi domeny. |
reverse | Embedded | Odwraca kierunek, w którym kreski rosną wzdłuż osi poziomej. |
set | Embedded | Ustawia kolor tła wykresu. |
set | Embedded | Zmienia typ wykresu. |
set | Embedded | Ustawia kolory linii na wykresie. |
set | Embedded | Określa strategię używaną w przypadku ukrytych wierszy i kolumn. |
set | Embedded | Określa położenie legendy względem wykresu. |
set | Embedded | Ustawia styl tekstu legendy wykresu. |
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 zakres wykresu. |
set | Embedded | Używa nakładanych linii, co oznacza, że wartości linii i pasków są nakładane (kumulowane). |
set | Embedded | Ustawia tytuł wykresu. |
set | Embedded | Ustawia styl tekstu tytułu wykresu. |
set | Embedded | Określa, czy wiersze i kolumny wykresu mają być zamieniane miejscami. |
set | Embedded | Ustawia styl tekstu osi poziomej. |
set | Embedded | Dodaje tytuł do osi poziomej. |
set | Embedded | Ustawia styl tekstu tytułu osi poziomej. |
set | Embedded | Ustawia styl tekstu osi pionowej. |
set | Embedded | Dodaje tytuł do osi pionowej. |
set | Embedded | Ustawia styl tekstu tytułu osi pionowej. |
use | Embedded | Przekształca oś zakresu w skalę logarytmiczną (wymaga, aby wszystkie wartości były dodatnie). |
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
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
reverse Categories()
Odwraca kolejność rysowania serii na osi domeny. W przypadku wykresów z zakresem pionowym (np. wykresów liniowych, powierzchniowych lub słupkowych) oznacza to, że oś pozioma jest rysowana od prawej do lewej. W przypadku wykresów z zakresem poziomym (np. wykresów słupkowych) oznacza to, że oś pionowa jest rysowana od góry do dołu. W przypadku wykresów kołowych oznacza to, że sektory są rysowane w przeciwnym kierunku do ruchu wskazówek zegara.
// Creates a pie chart builder and sets drawing of the slices in a // counter-clockwise manner. const builder = Charts.newPieChart(); builder.reverseCategories();
Powrót
Embedded
– ten kreator jest przydatny do łańcuchowania.
reverse Direction()
Odwraca kierunek, w którym kreski rosną wzdłuż osi poziomej. Domyślnie wartości rosną od lewej do prawej. Wywołanie tej metody powoduje, że elementy rosną od prawej do lewej.
Powrót
Embedded
– ten kreator jest przydatny do łańcuchowania.
set Background Color(cssValue)
Ustawia kolor tła wykresu.
// Creates a line chart builder and sets the background color to gray const builder = Charts.newLineChart(); builder.setBackgroundColor('gray');
Parametry
Nazwa | Typ | Opis |
---|---|---|
css | String | Wartość CSS koloru (np. "blue" lub "#00f" ). |
Powrót
Embedded
– ten kreator jest przydatny 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 Colors(cssValues)
Ustawia kolory linii na wykresie.
// Creates a line chart builder and sets the first two lines to be drawn in // green and red, respectively. const builder = Charts.newLineChart(); builder.setColors(['green', 'red']);
Parametry
Nazwa | Typ | Opis |
---|---|---|
css | String[] | Tablica wartości kolorów CSS, np. ["red", "#acf"] . Element n tablicy reprezentuje kolor linii n na wykresie. |
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 Legend Position(position)
Określa położenie legendy względem wykresu. Domyślnie legenda nie jest wyświetlana.
// Creates a line chart builder and sets the legend position to right. const builder = Charts.newLineChart(); builder.setLegendPosition(Charts.Position.RIGHT);
Parametry
Nazwa | Typ | Opis |
---|---|---|
position | Position | Pozycja legendy. |
Powrót
Embedded
– ten kreator jest przydatny do łańcuchowania.
set Legend Text Style(textStyle)
Ustawia styl tekstu legendy wykresu.
// Creates a line chart builder and sets it up for a blue, 26-point legend. const textStyleBuilder = Charts.newTextStyle().setColor('#0000FF').setFontSize(26); const style = textStyleBuilder.build(); const builder = Charts.newLineChart(); builder.setLegendTextStyle(style);
Parametry
Nazwa | Typ | Opis |
---|---|---|
text | Text | Styl tekstu używany w legendzie wykresu. |
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 Range(start, end)
Określa zakres wykresu.
Jeśli jakiekolwiek punkty danych znajdują się poza zakresem, zakres jest rozszerzany, aby obejmował te punkty danych.
Parametry
Nazwa | Typ | Opis |
---|---|---|
start | Number | Wartość odpowiadająca najniższej linii siatki osi zakresu. |
end | Number | Wartość najwyższej linii siatki osi zakresu. |
Powrót
Embedded
– ten kreator jest przydatny do łańcuchowania.
set Stacked()
Używa nakładanych linii, co oznacza, że wartości linii i pasków są nakładane (kumulowane). Domyślnie nie ma nakładania.
Powrót
Embedded
– ten kreator jest przydatny do łańcuchowania.
set Title(chartTitle)
Ustawia tytuł wykresu. Tytuł jest wyświetlany na środku nad wykresem.
// Creates a line chart builder and title to 'My Line Chart'. const builder = Charts.newLineChart(); builder.setTitle('My Line Chart');
Parametry
Nazwa | Typ | Opis |
---|---|---|
chart | String | tytuł wykresu. |
Powrót
Embedded
– ten kreator jest przydatny do łańcuchowania.
set Title Text Style(textStyle)
Ustawia styl tekstu tytułu wykresu.
// Creates a line chart builder and sets it up for a blue, 26-point title. const textStyleBuilder = Charts.newTextStyle().setColor('#0000FF').setFontSize(26); const style = textStyleBuilder.build(); const builder = Charts.newLineChart(); builder.setTitleTextStyle(style);
Parametry
Nazwa | Typ | Opis |
---|---|---|
text | Text | Styl tekstu, który ma być używany w tytule wykresu. Obiekt Text możesz utworzyć, wywołując funkcję Charts.newTextStyle() . |
Powrót
Embedded
– ten kreator jest przydatny 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
set XAxis Text Style(textStyle)
Ustawia styl tekstu osi poziomej.
// Creates a line chart builder and sets the X-axis text style to blue, 18-point // font. const textStyle = Charts.newTextStyle().setColor('blue').setFontSize(18).build(); const builder = Charts.newLineChart(); builder.setXAxisTextStyle(textStyle);
Parametry
Nazwa | Typ | Opis |
---|---|---|
text | Text | Styl tekstu, który ma być używany w tytule osi poziomej. Obiekt Text możesz utworzyć, wywołując funkcję Charts.newTextStyle() . |
Powrót
Embedded
– ten kreator jest przydatny do łańcuchowania.
set XAxis Title(title)
Dodaje tytuł do osi poziomej. Tytuł jest wyśrodkowany i wyświetlany pod etykietami wartości osi.
// Creates a line chart builder and sets the X-axis title. const builder = Charts.newLineChart(); builder.setTitle('X-axis Title');
Parametry
Nazwa | Typ | Opis |
---|---|---|
title | String | Tytuł osi X. |
Powrót
Embedded
– ten kreator jest przydatny do łańcuchowania.
set XAxis Title Text Style(textStyle)
Ustawia styl tekstu tytułu osi poziomej.
// Creates a line chart builder and sets the X-axis title text style to blue, // 18-point font. const textStyle = Charts.newTextStyle().setColor('blue').setFontSize(18).build(); const builder = Charts.newLineChart(); builder.setXAxisTitleTextStyle(textStyle);
Parametry
Nazwa | Typ | Opis |
---|---|---|
text | Text | Styl tekstu, który ma być używany w tytule osi poziomej. Obiekt Text możesz utworzyć, wywołując funkcję Charts.newTextStyle() . |
Powrót
Embedded
– ten kreator jest przydatny do łańcuchowania.
set YAxis Text Style(textStyle)
Ustawia styl tekstu osi pionowej.
// Creates a line chart builder and sets the Y-axis text style to blue, 18-point // font. const textStyle = Charts.newTextStyle().setColor('blue').setFontSize(18).build(); const builder = Charts.newLineChart(); builder.setYAxisTextStyle(textStyle);
Parametry
Nazwa | Typ | Opis |
---|---|---|
text | Text | Styl tekstu, który ma być używany w tytule osi poziomej. Obiekt Text możesz utworzyć, wywołując funkcję Charts.newTextStyle() . |
Powrót
Embedded
– ten kreator jest przydatny do łańcuchowania.
set YAxis Title(title)
Dodaje tytuł do osi pionowej. Tytuł jest wyśrodkowany i pojawia się po lewej stronie etykiet wartości.
// Creates a line chart builder and sets the Y-axis title. const builder = Charts.newLineChart(); builder.setYAxisTitle('Y-axis Title');
Parametry
Nazwa | Typ | Opis |
---|---|---|
title | String | Tytuł osi Y. |
Powrót
Embedded
– ten kreator jest przydatny do łańcuchowania.
set YAxis Title Text Style(textStyle)
Ustawia styl tekstu tytułu osi pionowej.
// Creates a line chart builder and sets the Y-axis title text style to blue, // 18-point font. const textStyle = Charts.newTextStyle().setColor('blue').setFontSize(18).build(); const builder = Charts.newLineChart(); builder.setYAxisTitleTextStyle(textStyle);
Parametry
Nazwa | Typ | Opis |
---|---|---|
text | Text | Styl tekstu, który ma być używany w tytule osi poziomej. Obiekt Text możesz utworzyć, wywołując funkcję Charts.newTextStyle() . |
Powrót
Embedded
– ten kreator jest przydatny do łańcuchowania.
use Log Scale()
Przekształca oś zakresu w skalę logarytmiczną (wymaga, aby wszystkie wartości były dodatnie). Zakres osi to oś pionowa w przypadku wykresów pionowych (np. liniowych, warstwowych lub kolumnowych) oraz oś pozioma w przypadku wykresów poziomych (np. słupkowych).
Powrót
Embedded
– ten kreator jest przydatny do łańcuchowania.