Kreator wykresów kołowych. 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. |
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 z wykresu, który modyfikuje ten kreator, określony zakres. |
reverse | Embedded | Odwraca rysowanie serii na osi domeny. |
set3D() | Embedded | Ustawia wykres jako trójwymiarowy. |
set | Embedded | Ustawia kolor tła wykresu. |
set | Embedded | Zmienia typ wykresu. |
set | Embedded | Ustawia kolory linii na wykresie. |
set | Embedded | Określa strategię, która ma być używana 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 | 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 | Ustawia tytuł wykresu. |
set | Embedded | Ustawia styl tekstu tytułu wykresu. |
set | Embedded | Określa, czy wiersze i kolumny wykresu są transponowane. |
Szczegółowa dokumentacja
add Range(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
Embedded
– ten kreator do łączenia.
as Area Chart()
Ustawia typ wykresu na AreaChart i zwraca Embedded
.
Powrót
Embedded
– narzędzie do tworzenia wykresów warstwowych.
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
– narzędzie do tworzenia wykresów kolumnowych.
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
– narzędzie do tworzenia wykresów liniowych.
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 wykresów punktowych.
as Table Chart()
Ustawia typ wykresu na TableChart i zwraca Embedded
.
Powrót
Embedded
– 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
Embedded
– utworzony wykres, który należy jeszcze dodać do arkusza kalkulacyjnego.
clear Ranges()
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
Embedded
– ten kreator do łączenia.
get Chart Type()
get Container()
Zwraca wykres Container
, 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
Container
– obiekt zawierający pozycję kontenera wykresu.
get Ranges()
Zwraca kopię listy zakresów, które obecnie dostarczają dane do tego wykresu. Użyj ikon add
i remove
, 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.
remove Range(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ą add
. 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
Embedded
– ten kreator do łączenia.
reverse Categories()
Odwraca rysowanie serii na osi domeny. W przypadku wykresów zakresu pionowego (np. liniowych, obszarowych lub kolumnowych) 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 wycinki są rysowane w kierunku przeciwnym 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 konstruktor jest przydatny do łączenia.
set3D()
Ustawia wykres jako trójwymiarowy.
Powrót
Embedded
– ten konstruktor jest przydatny do łączenia.
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 konstruktor jest przydatny do łączenia.
set Chart Type(type)
Zmienia typ wykresu. Nie wszystkie typy wykresów osadzonych są obecnie 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 łączenia.
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 CSS kolorów, np. ["red", "#acf"] . N-ty element tablicy reprezentuje kolor n-tej linii na wykresie. |
Powrót
Embedded
– ten konstruktor jest przydatny do łączenia.
set Hidden Dimension Strategy(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
Embedded
– ten kreator do łączenia.
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 | Położenie legendy. |
Powrót
Embedded
– ten konstruktor jest przydatny do łączenia.
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, który ma być używany w legendzie wykresu. |
Powrót
Embedded
– ten konstruktor jest przydatny do łączenia.
set Merge Strategy(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
Nazwa | Typ | Opis |
---|---|---|
merge | Chart | Strategia łączenia, której chcesz użyć. |
Powrót
Embedded
– ten kreator do łączenia.
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 łączenia.
set Option(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
Embedded
– ten kreator do łączenia.
set Position(anchorRowPos, anchorColPos, offsetX, offsetY)
Ustawia pozycję, zmieniając miejsce, w którym wykres pojawia się w arkuszu. 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 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
Embedded
– ten kreator do łączenia.
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 konstruktor jest przydatny do łączenia.
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 Charts.newTextStyle() . |
Powrót
Embedded
– ten konstruktor jest przydatny do łączenia.
set Transpose Rows And Columns(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
Nazwa | Typ | Opis |
---|---|---|
transpose | Boolean | Jeśli true , wiersze i kolumny użyte do utworzenia wykresu są transponowane. |
Powrót
Embedded
– ten kreator do łączenia.