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 instancji wykresu źródła danych, jeśli wykres jest wykresem ź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 | Zwracaj dane wewnątrz tego obiektu jako obiekt blob. |
getChartId() | Integer | Zwraca stabilny identyfikator wykresu, który jest unikalny w całym arkuszu kalkulacyjnym zawierającym wykres, lub null , jeśli wykres nie znajduje się w arkuszu kalkulacyjnym. |
getContainerInfo() | ContainerInfo | Zwraca informacje o pozycji wykresu w arkuszu. |
getHiddenDimensionStrategy() | ChartHiddenDimensionStrategy | Zwraca strategię używaną do obsługi ukrytych wierszy i kolumn. |
getMergeStrategy() | ChartMergeStrategy | Zwraca strategię scalania, jeśli istnieje więcej niż jeden zakres. |
getNumHeaders() | Integer | Zwraca liczbę wierszy lub kolumn zakresu traktowanych jako nagłówki. |
getOptions() | ChartOptions | Zwraca opcje wykresu, takie jak wysokość, kolory i osie. |
getRanges() | Range[] | Zwraca zakresy, których używa ten wykres jako źródło danych. |
getTransposeRowsAndColumns() | Boolean | Jeśli ma wartość true , wiersze i kolumny używane do wypełniania wykresu są przełączane. |
modify() | EmbeddedChartBuilder | Zwraca wartość EmbeddedChartBuilder , której można użyć do zmodyfikowania tego wykresu. |
Szczegółowa dokumentacja
asDataSourceChart()
Służy do przesyłania do instancji wykresu źródła danych, jeśli wykres jest wykresem źródła danych, lub null
w innym przypadku.
Powroty
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 do nazwy pliku odpowiednie rozszerzenie, na przykład „mójplik.pdf”. Zakładamy jednak, że część nazwy pliku, która występuje po ostatniej kropce (jeśli występuje), jest istniejącym rozszerzeniem, które należy zastąpić. W związku z tym „Lista zakupów.12.25.2014” zmieni się na „Lista zakupów.12.25.pdf”.
Aby sprawdzić dzienne limity konwersji, przeczytaj artykuł Limity w usługach Google. Nowo utworzone domeny Google Workspace mogą tymczasowo podlegać bardziej rygorystycznym limitom.
Parametry
Nazwa | Typ | Opis |
---|---|---|
contentType | String | Typ MIME, na który ma zostać przekonwertowany. W przypadku większości obiektów blob jedyną prawidłową opcją jest 'application/pdf' . W przypadku zdjęć w formacie BMP, GIF, JPEG lub PNG obowiązują dowolne z tych wartości: 'image/bmp' , 'image/gif' , 'image/jpeg' i 'image/png' . |
Powroty
Blob
– dane w postaci obiektu blob.
getBlob()
getChartId()
Zwraca stabilny identyfikator wykresu, który jest unikalny w całym arkuszu kalkulacyjnym zawierającym wykres, lub null
, jeśli wykres nie znajduje się w arkuszu kalkulacyjnym.
Powroty
Integer
– stabilny identyfikator wykresu.
getContainerInfo()
Zwraca informacje o pozycji wykresu w arkuszu.
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());
Powroty
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());
Powroty
ChartHiddenDimensionStrategy
– strategia używana w przypadku ukrytych wierszy i kolumn.
getMergeStrategy()
Zwraca strategię scalania, jeśli istnieje więcej niż jeden zakres. Jeśli ma wartość MERGE_ROWS
, wiersz jest scalony, a jeśli ma wartość MERGE_COLUMNS
, kolumny są scalone. 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());
Powroty
ChartMergeStrategy
– MERGE_ROWS
, jeśli wiersze są scalone między wieloma zakresami; MERGE_COLUMNS
, jeśli kolumny są scalone z wielu zakresów
getNumHeaders()
Zwraca liczbę wierszy lub kolumn zakresu traktowanych 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());
Powroty
Integer
– liczba wierszy lub kolumn traktowanych jako nagłówki. Wartości ujemne wskazują, że nagłówki są automatycznie wykrywane.
getOptions()
Zwraca opcje wykresu, takie jak wysokość, kolory i osie.
Zwracanych opcji nie można zmienić.
Powroty
ChartOptions
– opcje wykresu, takie jak wysokość, kolory i osie.
getRanges()
Zwraca zakresy, których używa ten wykres jako źródło 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()); }
Powroty
Range[]
– tablica zakresów, które służą jako źródło danych tego wykresu
getTransposeRowsAndColumns()
Jeśli ma wartość true
, wiersze i kolumny używane do wypełniania wykresu są przełączane. Wartość domyślna 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());
Powroty
Boolean
– true
, jeśli wiersze i kolumny używane do utworzenia wykresu są transponowane.
modify()
Zwraca wartość EmbeddedChartBuilder
, której można użyć do zmodyfikowania tego wykresu. Wywołaj polecenie 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);
Powroty
EmbeddedChartBuilder
– kreator do tworzenia umieszczonych wykresów