Rappresenta un grafico incorporato in un foglio di lavoro.
Questo esempio mostra come modificare un grafico esistente:
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);
Questo esempio mostra come creare un nuovo grafico:
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()); }
Metodi
Metodo | Tipo restituito | Breve descrizione |
---|---|---|
asDataSourceChart() | DataSourceChart | Trasmette a un'istanza del grafico dell'origine dati, se il grafico è un grafico di origine dati, o null
in caso contrario. |
getAs(contentType) | Blob | Restituisce i dati all'interno di questo oggetto sotto forma di blob convertito nel tipo di contenuto specificato. |
getBlob() | Blob | Restituisce i dati all'interno di questo oggetto sotto forma di blob. |
getChartId() | Integer | Restituisce un identificatore stabile per il grafico univoco nel foglio di lavoro contenente il grafico oppure null se il grafico non è presente in un foglio di lavoro. |
getContainerInfo() | ContainerInfo | Restituisce informazioni sulla posizione del grafico all'interno di un foglio. |
getHiddenDimensionStrategy() | ChartHiddenDimensionStrategy | Restituisce la strategia da utilizzare per la gestione di righe e colonne nascoste. |
getMergeStrategy() | ChartMergeStrategy | Restituisce la strategia di unione utilizzata quando esiste più di un intervallo. |
getNumHeaders() | Integer | Restituisce il numero di righe o colonne dell'intervallo che vengono trattati come intestazioni. |
getOptions() | ChartOptions | Restituisce le opzioni per questo grafico, ad esempio altezza, colori e assi. |
getRanges() | Range[] | Restituisce gli intervalli utilizzati da questo grafico come origine dati. |
getTransposeRowsAndColumns() | Boolean | Se il valore è true , le righe e le colonne utilizzate per popolare il grafico vengono scambiate. |
modify() | EmbeddedChartBuilder | Restituisce un valore EmbeddedChartBuilder che può essere utilizzato per modificare questo grafico. |
Documentazione dettagliata
asDataSourceChart()
Trasmette a un'istanza del grafico dell'origine dati, se il grafico è un grafico di origine dati, o null
in caso contrario.
Ritorni
DataSourceChart
: grafico dell'origine dati.
getAs(contentType)
Restituisce i dati all'interno di questo oggetto sotto forma di blob convertito nel tipo di contenuto specificato. Questo metodo aggiunge l'estensione appropriata al nome del file, ad esempio "myfile.pdf". Tuttavia, si presuppone che la parte del nome del file che segue l'ultimo punto (se presente) sia un'estensione esistente che deve essere sostituita. Di conseguenza, "ShoppingList.12.25.2014" diventa "ShoppingList.12.25.pdf".
Per visualizzare le quote giornaliere per le conversioni, consulta Quote per i servizi Google. I domini Google Workspace appena creati potrebbero essere temporaneamente soggetti a quote più severe.
Parametri
Nome | Tipo | Descrizione |
---|---|---|
contentType | String | Il tipo MIME in cui eseguire la conversione. Per la maggior parte dei blob, 'application/pdf' è l'unica opzione valida. Per le immagini in formato BMP, GIF, JPEG o PNG, è valido anche qualsiasi formato 'image/bmp' , 'image/gif' , 'image/jpeg' o 'image/png' . |
Ritorni
Blob
: i dati sotto forma di blob.
getBlob()
Restituisce i dati all'interno di questo oggetto sotto forma di blob.
Ritorni
Blob
: i dati sotto forma di blob.
getChartId()
Restituisce un identificatore stabile per il grafico univoco nel foglio di lavoro contenente il grafico oppure null
se il grafico non è presente in un foglio di lavoro.
Ritorni
Integer
: un identificatore del grafico stabile.
getContainerInfo()
Restituisce informazioni sulla posizione del grafico all'interno di un foglio.
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());
Ritorni
ContainerInfo
: un oggetto contenente la posizione del contenitore del grafico
getHiddenDimensionStrategy()
Restituisce la strategia da utilizzare per la gestione di righe e colonne nascoste. Il valore predefinito è 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());
Ritorni
ChartHiddenDimensionStrategy
: strategia da utilizzare per righe e colonne nascoste.
getMergeStrategy()
Restituisce la strategia di unione utilizzata quando esiste più di un intervallo. Con MERGE_ROWS
, le righe vengono unite; con MERGE_COLUMNS
, le colonne vengono unite. Il valore predefinito è 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());
Ritorni
ChartMergeStrategy
: MERGE_ROWS
se le righe vengono unite in più intervalli; MERGE_COLUMNS
se le colonne vengono unite in più intervalli
getNumHeaders()
Restituisce il numero di righe o colonne dell'intervallo che vengono trattati come intestazioni.
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());
Ritorni
Integer
: il numero di righe o colonne trattate come intestazioni. I valori negativi indicano che le intestazioni vengono rilevate automaticamente.
getOptions()
Restituisce le opzioni per questo grafico, ad esempio altezza, colori e assi.
Le opzioni restituite sono immutabili.
Ritorni
ChartOptions
: le opzioni di questo grafico, ad esempio altezza, colori e assi.
getRanges()
Restituisce gli intervalli utilizzati da questo grafico come origine dati.
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()); }
Ritorni
Range[]
: un array di intervalli che fungono da origine dati per questo grafico
getTransposeRowsAndColumns()
Se il valore è true
, le righe e le colonne utilizzate per popolare il grafico vengono scambiate. Il valore predefinito è 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());
Ritorni
Boolean
: true
se le righe e le colonne utilizzate per creare il grafico sono trasposte.
modify()
Restituisce un valore EmbeddedChartBuilder
che può essere utilizzato per modificare questo grafico. Richiama sheet.updateChart(chart)
per salvare le modifiche.
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);
Ritorni
EmbeddedChartBuilder
: uno strumento per la creazione di grafici incorporati