Strumento per la creazione di grafici a dispersione. Per ulteriori dettagli, consulta la documentazione di Gviz.
Metodi
Metodo | Tipo restituito | Breve descrizione |
---|---|---|
add | Embedded | Aggiunge un intervallo al grafico modificato da questo generatore. |
as | Embedded | Imposta il tipo di grafico su AreaChart e restituisce un Embedded . |
as | Embedded | Imposta il tipo di grafico su BarChart e restituisce un Embedded . |
as | Embedded | Imposta il tipo di grafico su ColumnChart e restituisce un Embedded . |
as | Embedded | Imposta il tipo di grafico su ComboChart e restituisce un Embedded . |
as | Embedded | Imposta il tipo di grafico su HistogramChart e restituisce un Embedded . |
as | Embedded | Imposta il tipo di grafico su LineChart e restituisce un Embedded . |
as | Embedded | Imposta il tipo di grafico su PieChart e restituisce un Embedded . |
as | Embedded | Imposta il tipo di grafico su ScatterChart e restituisce un Embedded . |
as | Embedded | Imposta il tipo di grafico su TableChart e restituisce un Embedded . |
build() | Embedded | Il grafico viene creato in modo da riflettere tutte le modifiche apportate. |
clear | Embedded | Rimuove tutti gli intervalli dal grafico modificato da questo generatore. |
get | Chart | Restituisce il tipo di grafico corrente. |
get | Container | Restituisce il grafico Container , che racchiude la posizione in cui il grafico viene visualizzato nel foglio. |
get | Range[] | Restituisce una copia dell'elenco degli intervalli che attualmente forniscono i dati per questo grafico. |
remove | Embedded | Rimuove l'intervallo specificato dal grafico modificato da questo generatore. |
set | Embedded | Imposta il colore di sfondo del grafico. |
set | Embedded | Modifica il tipo di grafico. |
set | Embedded | Imposta i colori delle linee nel grafico. |
set | Embedded | Imposta la strategia da utilizzare per le righe e le colonne nascoste. |
set | Embedded | Imposta la posizione della legenda rispetto al grafico. |
set | Embedded | Imposta lo stile del testo della legenda del grafico. |
set | Embedded | Imposta la strategia di unione da utilizzare quando esiste più di un intervallo. |
set | Embedded | Imposta il numero di righe o colonne dell'intervallo da trattare come intestazioni. |
set | Embedded | Imposta le opzioni avanzate per questo grafico. |
set | Embedded | Imposta lo stile dei punti della linea. |
set | Embedded | Imposta la posizione, modificando la posizione del grafico nel foglio. |
set | Embedded | Imposta il titolo del grafico. |
set | Embedded | Imposta lo stile del testo del titolo del grafico. |
set | Embedded | Imposta se le righe e le colonne del grafico devono essere trasposte. |
set | Embedded | Imposta l'asse orizzontale su una scala logaritmica (è necessario che tutti i valori siano positivi). |
set | Embedded | Imposta l'intervallo per l'asse orizzontale del grafico. |
set | Embedded | Imposta lo stile del testo dell'asse orizzontale. |
set | Embedded | Aggiunge un titolo all'asse orizzontale. |
set | Embedded | Imposta lo stile del testo del titolo dell'asse orizzontale. |
set | Embedded | Imposta l'asse verticale su una scala logaritmica (è necessario che tutti i valori siano positivi). |
set | Embedded | Imposta l'intervallo per l'asse verticale del grafico. |
set | Embedded | Imposta lo stile del testo dell'asse verticale. |
set | Embedded | Aggiunge un titolo all'asse verticale. |
set | Embedded | Imposta lo stile del testo del titolo dell'asse verticale. |
Documentazione dettagliata
add Range(range)
Aggiunge un intervallo al grafico modificato da questo generatore. Non aggiunge l'intervallo se è già stato aggiunto al grafico.
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);
Parametri
Nome | Tipo | Descrizione |
---|---|---|
range | Range | L'intervallo da aggiungere. |
Invio
Embedded
: questo generatore, per l'accodamento
as Area Chart()
Imposta il tipo di grafico su AreaChart e restituisce un Embedded
.
Invio
Embedded
: uno strumento per la creazione di un grafico ad area
as Bar Chart()
Imposta il tipo di grafico su BarChart e restituisce un Embedded
.
Invio
Embedded
: uno strumento per la creazione di un grafico a barre
as Column Chart()
Imposta il tipo di grafico su ColumnChart e restituisce un Embedded
.
Invio
Embedded
: uno strumento per la creazione di un grafico a colonne
as Combo Chart()
Imposta il tipo di grafico su ComboChart e restituisce un Embedded
.
Invio
Embedded
: uno strumento per la creazione di un grafico combinato
as Histogram Chart()
Imposta il tipo di grafico su HistogramChart e restituisce un Embedded
.
Invio
Embedded
: uno strumento per la creazione di un istogramma
as Line Chart()
Imposta il tipo di grafico su LineChart e restituisce un Embedded
.
Invio
Embedded
: un generatore di grafici a linee
as Pie Chart()
Imposta il tipo di grafico su PieChart e restituisce un Embedded
.
Invio
Embedded
: uno strumento per la creazione di un grafico a torta
as Scatter Chart()
Imposta il tipo di grafico su ScatterChart e restituisce un Embedded
.
Invio
Embedded
: uno strumento per la creazione di un grafico a dispersione
as Table Chart()
Imposta il tipo di grafico su TableChart e restituisce un Embedded
.
Invio
Embedded
: uno strumento per la creazione di un grafico a tabella
build()
Il grafico viene creato in modo da riflettere tutte le modifiche apportate.
Questo metodo non disegna automaticamente il grafico sopra il foglio di lavoro. Un nuovo grafico deve essere inserito tramite sheet.insertChart(chart)
e un grafico esistente deve essere aggiornato tramite 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);
Invio
Embedded
: il grafico creato, che deve ancora essere aggiunto al foglio di lavoro
clear Ranges()
Rimuove tutti gli intervalli dal grafico modificato da questo generatore.
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);
Invio
Embedded
: questo generatore, per l'accodamento
get Chart Type()
get Container()
Restituisce il grafico Container
, che racchiude la posizione in cui il grafico viene visualizzato nel foglio.
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(), );
Invio
Container
: un oggetto contenente la posizione del contenitore del grafico
get Ranges()
Restituisce una copia dell'elenco degli intervalli che attualmente forniscono i dati per questo grafico. Utilizza add
e remove
per modificare questo elenco.
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()); }
Invio
Range[]
: un array di intervalli che fungono da origine dati del grafico da creare
remove Range(range)
Rimuove l'intervallo specificato dal grafico modificato da questo generatore. Non viene generato un errore se l'intervallo non è presente in questo grafico.
L'intervallo rimosso deve corrispondere a un intervallo aggiunto tramite add
;
altrimenti non viene apportata alcuna modifica al grafico. Questo metodo non può essere utilizzato per rimuovere parzialmente i valori da un intervallo.
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 will render 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 // will not be removed, and will not throw an exception chartBuilder.removeRange(firstRange); chartBuilder.removeRange(sheet.getRange('A6:B8')); const chart = chartBuilder.build(); sheet.insertChart(chart);
Parametri
Nome | Tipo | Descrizione |
---|---|---|
range | Range | L'intervallo da rimuovere. |
Invio
Embedded
: questo generatore, per l'accodamento
set Background Color(cssValue)
Imposta il colore di sfondo del grafico.
// Creates a line chart builder and sets the background color to gray const builder = Charts.newLineChart(); builder.setBackgroundColor('gray');
Parametri
Nome | Tipo | Descrizione |
---|---|---|
css | String | Il valore CSS del colore (ad esempio "blue" o "#00f" ). |
Invio
Embedded
: questo builder è utile per l'accodamento.
set Chart Type(type)
Modifica il tipo di grafico. Al momento non tutti i tipi di grafici incorporati sono supportati. Leggi i 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);
Parametri
Nome | Tipo | Descrizione |
---|---|---|
type | Chart | Il tipo in cui modificare il grafico. |
Invio
Embedded
: questo generatore, per l'accodamento
set Colors(cssValues)
Imposta i colori delle linee nel grafico.
// 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']);
Parametri
Nome | Tipo | Descrizione |
---|---|---|
css | String[] | Un array di valori CSS di colore, ad esempio ["red", "#acf"] . L'elemento n-esimo
nell'array rappresenta il colore della riga n-esima nel grafico. |
Invio
Embedded
: questo builder è utile per l'accodamento.
set Hidden Dimension Strategy(strategy)
Imposta la strategia da utilizzare per le righe e le colonne nascoste. Il valore predefinito è 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);
Parametri
Nome | Tipo | Descrizione |
---|---|---|
strategy | Chart | La strategia da utilizzare per le righe e le colonne nascoste. |
Invio
Embedded
: questo generatore, per l'accodamento
set Legend Position(position)
Imposta la posizione della legenda rispetto al grafico. Per impostazione predefinita, non è presente alcuna legenda.
// Creates a line chart builder and sets the legend position to right. const builder = Charts.newLineChart(); builder.setLegendPosition(Charts.Position.RIGHT);
Parametri
Nome | Tipo | Descrizione |
---|---|---|
position | Position | La posizione della legenda. |
Invio
Embedded
: questo builder è utile per l'accodamento.
set Legend Text Style(textStyle)
Imposta lo stile del testo della legenda del grafico.
// 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);
Parametri
Nome | Tipo | Descrizione |
---|---|---|
text | Text | Lo stile di testo da utilizzare per la legenda del grafico. |
Invio
Embedded
: questo builder è utile per l'accodamento.
set Merge Strategy(mergeStrategy)
Imposta la strategia di unione da utilizzare 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
.
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);
Parametri
Nome | Tipo | Descrizione |
---|---|---|
merge | Chart | La strategia di unione da utilizzare. |
Invio
Embedded
: questo generatore, per l'accodamento
set Num Headers(headers)
Imposta il numero di righe o colonne dell'intervallo da trattare come intestazioni.
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);
Parametri
Nome | Tipo | Descrizione |
---|---|---|
headers | Integer | Il numero di righe o colonne da considerare come intestazioni. I valori negativi fanno sì che le intestazioni vengano rilevate automaticamente. |
Invio
Embedded
: questo generatore, per l'accodamento
set Option(option, value)
Imposta le opzioni avanzate per questo grafico. Per visualizzare un elenco delle opzioni disponibili, consulta Opzioni di configurazione dei grafici.
Questo metodo non convalida l'opzione specificata come valida per questo tipo di grafico né se il valore è nel formato/nella struttura corretti.
Questo esempio mostra come modificare il titolo e impostare una legenda.
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();
Parametri
Nome | Tipo | Descrizione |
---|---|---|
option | String | Il nome dell'opzione. |
value | Object | Il valore dell'opzione. |
Invio
Embedded
: questo generatore, per l'accodamento.
set Point Style(style)
Imposta lo stile dei punti della linea. Per impostazione predefinita, i punti non hanno stili particolari ed è visibile solo la linea.
// Creates a line chart builder and sets large point style. const builder = Charts.newLineChart(); builder.setPointStyle(Charts.PointStyle.LARGE);
Parametri
Nome | Tipo | Descrizione |
---|---|---|
style | Point | Lo stile da utilizzare per i punti della linea. |
Invio
Embedded
: questo builder è utile per l'accodamento.
Vedi anche
set Position(anchorRowPos, anchorColPos, offsetX, offsetY)
Imposta la posizione, modificando la posizione del grafico nel foglio. anchor
e
anchor
sono indicizzati da 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);
Parametri
Nome | Tipo | Descrizione |
---|---|---|
anchor | Integer | Il lato superiore del grafico è ancorato a questa riga. |
anchor | Integer | Il lato sinistro del grafico è ancorato a questa colonna. |
offsetX | Integer | L'angolo in alto a destra del grafico è spostato di questo numero di pixel. |
offsetY | Integer | L'angolo in basso a sinistra del grafico è offset di questo numero di pixel. |
Invio
Embedded
: questo generatore, per l'accodamento
set Title(chartTitle)
Imposta il titolo del grafico. Il titolo viene visualizzato al centro sopra il grafico.
// Creates a line chart builder and title to 'My Line Chart'. const builder = Charts.newLineChart(); builder.setTitle('My Line Chart');
Parametri
Nome | Tipo | Descrizione |
---|---|---|
chart | String | il titolo del grafico. |
Invio
Embedded
: questo builder è utile per l'accodamento.
set TitleTextStyle(textStyle)
Imposta lo stile del testo del titolo del grafico.
// 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);
Parametri
Nome | Tipo | Descrizione |
---|---|---|
text | Text | Lo stile di testo da utilizzare per il titolo del grafico. Puoi creare un oggetto Text chiamando Charts.newTextStyle() . |
Invio
Embedded
: questo builder è utile per l'accodamento.
set Transpose Rows And Columns(transpose)
Imposta se le righe e le colonne del grafico devono essere trasposte. Se impostato su true
, le righe e le colonne vengono scambiate. Il valore predefinito è 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);
Parametri
Nome | Tipo | Descrizione |
---|---|---|
transpose | Boolean | Se true , le righe e le colonne utilizzate per creare il grafico vengono trasposte. |
Invio
Embedded
: questo generatore, per l'accodamento
set XAxis Log Scale()
Imposta l'asse orizzontale su una scala logaritmica (è necessario che tutti i valori siano positivi).
Invio
Embedded
: questo builder è utile per l'accodamento.
set XAxis Range(start, end)
Imposta l'intervallo per l'asse orizzontale del grafico.
Se alcuni punti dati non rientrano nell'intervallo, questo viene espanso in modo da includerli.
// Creates a scatter chart builder and sets the X-axis range to be 0 to 100. const builder = Charts.newTableChart(); builder.setXAxisRange(0, 100);
Parametri
Nome | Tipo | Descrizione |
---|---|---|
start | Number | Il valore della riga della griglia più bassa dell'asse orizzontale. |
end | Number | Il valore della linea di griglia più alta dell'asse orizzontale. |
Invio
Embedded
: questo builder è utile per l'accodamento.
set XAxis Text Style(textStyle)
Imposta lo stile del testo dell'asse orizzontale.
// Creates a line chart builder and sets the X-axis text style to blue, 18-point // font. const textStyle = Charts.newTextStyle().setColor('blue').setFontSize(18).build(); const builder = Charts.newLineChart(); builder.setXAxisTextStyle(textStyle);
Parametri
Nome | Tipo | Descrizione |
---|---|---|
text | Text | Lo stile di testo da utilizzare per il titolo dell'asse orizzontale. Puoi creare un oggetto Text chiamando Charts.newTextStyle() . |
Invio
Embedded
: questo builder è utile per l'accodamento.
set XAxis Title(title)
Aggiunge un titolo all'asse orizzontale. Il titolo è centrato e viene visualizzato sotto le etichette del valore dell'asse.
// Creates a line chart builder and sets the X-axis title. const builder = Charts.newLineChart(); builder.setTitle('X-axis Title');
Parametri
Nome | Tipo | Descrizione |
---|---|---|
title | String | Il titolo dell'asse X. |
Invio
Embedded
: questo builder è utile per l'accodamento.
set XAxis TitleTextStyle(textStyle)
Imposta lo stile del testo del titolo dell'asse orizzontale.
// Creates a line chart builder and sets the X-axis title text style to blue, // 18-point font. const textStyle = Charts.newTextStyle().setColor('blue').setFontSize(18).build(); const builder = Charts.newLineChart(); builder.setXAxisTitleTextStyle(textStyle);
Parametri
Nome | Tipo | Descrizione |
---|---|---|
text | Text | Lo stile di testo da utilizzare per il titolo dell'asse orizzontale. Puoi creare un oggetto Text chiamando Charts.newTextStyle() . |
Invio
Embedded
: questo builder è utile per l'accodamento.
set YAxis Log Scale()
Imposta l'asse verticale su una scala logaritmica (è necessario che tutti i valori siano positivi).
Invio
Embedded
: questo builder è utile per l'accodamento.
set YAxis Range(start, end)
Imposta l'intervallo per l'asse verticale del grafico. Se alcuni punti dati non rientrano nell'intervallo, l'intervallo viene espanso per includerli.
// Creates a scatter chart builder and sets the Y-axis range to be 0 to 100. const builder = Charts.newTableChart(); builder.setYAxisRange(0, 100);
Parametri
Nome | Tipo | Descrizione |
---|---|---|
start | Number | Il valore della linea di griglia più bassa dell'asse verticale. |
end | Number | Il valore della linea di griglia più alta dell'asse verticale. |
Invio
Embedded
: questo builder è utile per l'accodamento.
set YAxis Text Style(textStyle)
Imposta lo stile del testo dell'asse verticale.
// Creates a line chart builder and sets the Y-axis text style to blue, 18-point // font. const textStyle = Charts.newTextStyle().setColor('blue').setFontSize(18).build(); const builder = Charts.newLineChart(); builder.setYAxisTextStyle(textStyle);
Parametri
Nome | Tipo | Descrizione |
---|---|---|
text | Text | Lo stile di testo da utilizzare per il titolo dell'asse orizzontale. Puoi creare un oggetto Text chiamando Charts.newTextStyle() . |
Invio
Embedded
: questo builder è utile per l'accodamento.
set YAxis Title(title)
Aggiunge un titolo all'asse verticale. Il titolo è centrato e viene visualizzato a sinistra delle etichette dei valori.
// Creates a line chart builder and sets the Y-axis title. const builder = Charts.newLineChart(); builder.setYAxisTitle('Y-axis Title');
Parametri
Nome | Tipo | Descrizione |
---|---|---|
title | String | Il titolo dell'asse Y. |
Invio
Embedded
: questo builder è utile per l'accodamento.
set YAxis TitleTextStyle(textStyle)
Imposta lo stile del testo del titolo dell'asse verticale.
// Creates a line chart builder and sets the Y-axis title text style to blue, // 18-point font. const textStyle = Charts.newTextStyle().setColor('blue').setFontSize(18).build(); const builder = Charts.newLineChart(); builder.setYAxisTitleTextStyle(textStyle);
Parametri
Nome | Tipo | Descrizione |
---|---|---|
text | Text | Lo stile di testo da utilizzare per il titolo dell'asse orizzontale. Puoi creare un oggetto Text chiamando Charts.newTextStyle() . |
Invio
Embedded
: questo builder è utile per l'accodamento.