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 la trasmissione a un'istanza del grafico di origine dati se il grafico è un grafico di origine dati oppure null
negli altri casi. |
getAs(contentType) | Blob | Restituisce i dati all'interno di questo oggetto come blob convertito nel tipo di contenuto specificato. |
getBlob() | Blob | Restituisce i dati all'interno dell'oggetto sotto forma di blob. |
getChartId() | Integer | Restituisce un identificatore stabile per il grafico, univoco nel foglio di lavoro contenente
grafico o null se il grafico non si trova 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 gestire le righe e le 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 trattate come intestazioni. |
getOptions() | ChartOptions | Restituisce le opzioni per il grafico, come altezza, colori e assi. |
getRanges() | Range[] | Restituisce gli intervalli utilizzati dal grafico come origine dati. |
getTransposeRowsAndColumns() | Boolean | Se true , le righe e le colonne utilizzate per completare il grafico vengono invertite. |
modify() | EmbeddedChartBuilder | Restituisce un valore EmbeddedChartBuilder che può essere utilizzato per modificare il grafico. |
Documentazione dettagliata
asDataSourceChart()
Trasmette la trasmissione a un'istanza del grafico di origine dati se il grafico è un grafico di origine dati oppure null
negli altri casi.
Invio
DataSourceChart
: il grafico dell'origine dati.
getAs(contentType)
Restituisce i dati all'interno di questo oggetto come blob convertito nel tipo di contenuto specificato. Questo aggiunge l'estensione appropriata al nome del file, ad esempio "miofile.pdf". Tuttavia, presuppone che la parte del nome file che segue l'ultimo punto (se presente) sia una un'estensione che deve essere sostituita. Di conseguenza, "ShoppingList.25.12.2014" diventa "ShoppingList.12.25.pdf".
Per visualizzare le quote giornaliere per le conversioni, consulta Quote per Google Servizi. I domini Google Workspace appena creati potrebbero essere temporaneamente soggetti a restrizioni quote.
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, vengono visualizzati anche i valori 'image/bmp' , 'image/gif' , 'image/jpeg' o 'image/png'
valida. Per un documento di Documenti Google è valido anche 'text/markdown' . |
Invio
Blob
: i dati come blob.
getBlob()
getChartId()
Restituisce un identificatore stabile per il grafico, univoco nel foglio di lavoro contenente
grafico o null
se il grafico non si trova in un foglio di lavoro.
Invio
Integer
: un identificatore stabile del grafico.
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());
Invio
ContainerInfo
: un oggetto contenente la posizione del contenitore del grafico
getHiddenDimensionStrategy()
Restituisce la strategia da utilizzare per gestire le righe e le 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());
Invio
ChartHiddenDimensionStrategy
: la strategia da utilizzare per le righe e le colonne nascoste.
getMergeStrategy()
Restituisce la strategia di unione utilizzata quando esiste più di un intervallo. Se MERGE_ROWS
, le righe vengono unite; Se 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());
Invio
ChartMergeStrategy
: MERGE_ROWS
se le righe sono unite in più righe
intervalli; MERGE_COLUMNS
se le colonne sono unite
in più intervalli
getNumHeaders()
Restituisce il numero di righe o colonne dell'intervallo trattate 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());
Invio
Integer
: il numero di righe o colonne trattate come intestazioni. I valori negativi indicano le intestazioni
vengono rilevati automaticamente.
getOptions()
Restituisce le opzioni per il grafico, come altezza, colori e assi.
Le opzioni restituite sono immutabili.
Invio
ChartOptions
: le opzioni per questo grafico, ad esempio altezza, colori e assi.
getRanges()
Restituisce gli intervalli utilizzati dal 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()); }
Invio
Range[]
: un array di intervalli che funge da origine dati di questo grafico
getTransposeRowsAndColumns()
Se true
, le righe e le colonne utilizzate per completare il grafico vengono invertite. 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());
Invio
Boolean
: true
se le righe e le colonne utilizzate per costruire il grafico vengono trasposti.
modify()
Restituisce un valore EmbeddedChartBuilder
che può essere utilizzato per modificare il 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);
Invio
EmbeddedChartBuilder
: uno strumento per la creazione di grafici incorporati