Reprezentuje wykres umieszczony w arkuszu kalkulacyjnym.
Ten przykład pokazuje, jak zmodyfikować istniejący wykres:
var sheet = SpreadsheetApp.getActiveSheet(); var range = sheet.getRange("A2:B8") var chart = sheet.getCharts()[0]; chart = chart.modify() .addRange(range) .setOption('title', 'Updated!') .setOption('animation.duration', 500) .setPosition(2,2,0,0) .build(); sheet.updateChart(chart);
Ten przykład pokazuje, jak utworzyć nowy wykres:
function newChart(range, sheet) { var sheet = SpreadsheetApp.getActiveSheet(); var chartBuilder = sheet.newChart(); chartBuilder.addRange(range) .setChartType(Charts.ChartType.LINE) .setOption('title', 'My Line Chart!'); sheet.insertChart(chartBuilder.build()); }
Metody
Metoda | Zwracany typ | Krótki opis |
---|---|---|
asDataSourceChart() | DataSourceChart | Służy do przesyłania do wykresu instancji źródła danych, jeśli jest to wykres źródła danych lub null w innym przypadku. |
getAs(contentType) | Blob | Zwraca dane wewnątrz tego obiektu jako obiekt blob przekonwertowany na określony typ treści. |
getBlob() | Blob | Zwraca dane wewnątrz tego obiektu jako blob. |
getChartId() | Integer | Zwraca stabilny identyfikator wykresu niepowtarzalnego w arkuszu kalkulacyjnym zawierającym wykres lub null , jeśli wykresu nie ma w arkuszu. |
getContainerInfo() | ContainerInfo | Zwraca informacje o tym, w którym miejscu arkusza znajduje się wykres. |
getHiddenDimensionStrategy() | ChartHiddenDimensionStrategy | Zwraca strategię używaną do obsługi ukrytych wierszy i kolumn. |
getMergeStrategy() | ChartMergeStrategy | Zwraca strategię scalania używaną w przypadku występowania więcej niż 1 zakresu. |
getNumHeaders() | Integer | Zwraca liczbę wierszy i kolumn zakresu, które są traktowane jako nagłówki. |
getOptions() | ChartOptions | Zwraca opcje tego wykresu, takie jak wysokość, kolory i osie. |
getRanges() | Range[] | Zwraca zakresy, których ten wykres używa jako źródła danych. |
getTransposeRowsAndColumns() | Boolean | Jeśli wybierzesz true , wiersze i kolumny użyte do wypełnienia wykresu zostaną zmienione. |
modify() | EmbeddedChartBuilder | Zwraca wartość EmbeddedChartBuilder , która służy do modyfikowania tego wykresu. |
Szczegółowa dokumentacja
asDataSourceChart()
Służy do przesyłania do wykresu instancji źródła danych, jeśli jest to wykres źródła danych lub null
w innym przypadku.
Zwróć
DataSourceChart
– wykres źródła danych,
getAs(contentType)
Zwraca dane wewnątrz tego obiektu jako obiekt blob przekonwertowany na określony typ treści. Ta metoda dodaje odpowiednie rozszerzenie do nazwy pliku, np. „"myfile.pdf"”. Zakładamy jednak, że część nazwy pliku po ostatnim okresie (jeśli w ogóle) jest rozszerzeniem, które należy zastąpić. W związku z tym "ShoppingList.12.25.2014" zmienia się w "ShoppingList.12.25.pdf".
Aby sprawdzić dzienne limity konwersji, zobacz Limity usług Google. Nowo utworzone domeny Google Workspace mogą podlegać tymczasowym ograniczeniom.
Parametry
Nazwa | Typ | Opis |
---|---|---|
contentType | String | Typ MIME, na który ma zostać przekonwertowane. W większości blobów 'application/pdf' jest jedyną prawidłową opcją. W przypadku obrazów w formacie BMP, GIF, JPEG lub PNG prawidłowy jest też każdy z tych formatów: 'image/bmp' , 'image/gif' , 'image/jpeg' lub 'image/png' . |
Zwróć
Blob
– dane jako obiekt blob.
getBlob()
getChartId()
Zwraca stabilny identyfikator wykresu niepowtarzalnego w arkuszu kalkulacyjnym zawierającym wykres lub null
, jeśli wykresu nie ma w arkuszu.
Zwróć
Integer
– stabilny identyfikator wykresu,
getContainerInfo()
Zwraca informacje o tym, w którym miejscu arkusza znajduje się wykres.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var chart = sheet.newChart() .setChartType(Charts.ChartType.BAR) .addRange(sheet.getRange("A1:B8")) .setPosition(5, 5, 0, 0) .build(); var containerInfo = chart.getContainerInfo(); // Logs the values we 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());
Zwróć
ContainerInfo
– obiekt zawierający pozycję kontenera wykresu,
getHiddenDimensionStrategy()
Zwraca strategię używaną do obsługi ukrytych wierszy i kolumn. Domyślna wartość to IGNORE_ROWS
.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var range = sheet.getRange("A1:B5"); var chart = sheet.newChart() .setChartType(Charts.ChartType.BAR) .addRange(range) .setHiddenDimensionStrategy(Charts.ChartHiddenDimensionStrategy.IGNORE_COLUMNS) .setPosition(5, 5, 0, 0) .build() // Logs the strategy to use for hidden rows and columns which is // Charts.ChartHiddenDimensionStrategy.IGNORE_COLUMNS in this case. Logger.log(chart.getHiddenDimensionStrategy());
Zwróć
ChartHiddenDimensionStrategy
– strategia używana do ukrywania wierszy i kolumn.
getMergeStrategy()
Zwraca strategię scalania używaną w przypadku występowania więcej niż 1 zakresu. Jeśli wiersz MERGE_ROWS
jest scalony, kolumny MERGE_COLUMNS
są scalane. Domyślna wartość to MERGE_COLUMNS
.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var range = sheet.getRange("A1:B10"); var range2 = sheet.getRange("C1:C10"); var chart = sheet.newChart() .setChartType(Charts.ChartType.BAR) .addRange(range) .addRange(range2) .setMergeStrategy(Charts.ChartMergeStrategy.MERGE_ROWS) .setPosition(5, 5, 0, 0) .build() // Logs whether rows of multiple ranges are merged, which is MERGE_ROWS in this case. Logger.log(chart.getMergeStrategy());
Zwróć
ChartMergeStrategy
– MERGE_ROWS
, jeśli wiersze zostały scalone w wiele zakresów; MERGE_COLUMNS
, jeśli kolumny zostały scalone w wiele zakresów
getNumHeaders()
Zwraca liczbę wierszy i kolumn zakresu, które są traktowane jako nagłówki.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var range = sheet.getRange("A1:B5"); var chart = sheet.newChart() .setChartType(Charts.ChartType.BAR) .addRange(range) .setNumHeaders(1) .setPosition(5, 5, 0, 0) .build() // Logs the number of rows or columns to use as headers, which is 1 in this case. Logger.log(chart.getHeaders());
Zwróć
Integer
– liczba wierszy lub kolumn traktowanych jako nagłówki. Wartości ujemne oznaczają nagłówki wykryte automatycznie.
getOptions()
Zwraca opcje tego wykresu, takie jak wysokość, kolory i osie.
Zwrócone opcje są stałe.
Zwróć
ChartOptions
– opcje tego wykresu, takie jak wysokość, kolory i osie.
getRanges()
Zwraca zakresy, których ten wykres używa jako źródła danych.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var chart = sheet.newChart() .setChartType(Charts.ChartType.BAR) .addRange(sheet.getRange("A1:B8")) .setPosition(5, 5, 0, 0) .build(); var ranges = chart.getRanges(); // There's only one range as a data source for this chart, // so this logs "A1:B8" for (var i in ranges) { var range = ranges[i]; Logger.log(range.getA1Notation()); }
Zwróć
Range[]
– tablica zakresów, które służą jako źródło danych na tym wykresie;
getTransposeRowsAndColumns()
Jeśli wybierzesz true
, wiersze i kolumny użyte do wypełnienia wykresu zostaną zmienione. Domyślna wartość to false
.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var range = sheet.getRange("A1:B5"); var chart = sheet.newChart() .addRange(range) .setChartType(Charts.ChartType.BAR) .setTransposeRowsAndColumns(true) .setPosition(5, 5, 0, 0) .build() // Logs whether rows and columns should be transposed, which is true in this case. Logger.log(chart.getTransposeRowsAndColumns());
Zwróć
Boolean
– true
, jeśli wiersze i kolumny użyte do utworzenia wykresu zostały przetranskrybowane.
modify()
Zwraca wartość EmbeddedChartBuilder
, która służy do modyfikowania tego wykresu. Wywołaj sheet.updateChart(chart)
, aby zapisać zmiany.
var sheet = SpreadsheetApp.getActiveSheet(); var chart = sheet.getCharts()[0]; chart = chart.modify() .setOption('width', 800) .setOption('height', 640) .setPosition(5, 5, 0, 0) .build(); sheet.updateChart(chart);
Zwróć
EmbeddedChartBuilder
– kreatywny wykres do umieszczenia na stronie