Generatore di grafici a barre. Per maggiori dettagli, consulta la documentazione di Gviz.
Metodi
Metodo | Tipo restituito | Breve descrizione |
---|---|---|
add | Embedded | Aggiunge un intervallo al grafico che questo generatore modifica. |
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 | Crea il grafico in modo che rifletta 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 indica la posizione in cui viene visualizzato il grafico nel foglio. |
get | Range[] | Restituisce una copia dell'elenco degli intervalli che forniscono attualmente dati per questo grafico. |
remove | Embedded | Rimuove l'intervallo specificato dal grafico modificato da questo generatore. |
reverse | Embedded | Inverte il disegno delle serie nell'asse del dominio. |
reverse | Embedded | Inverte la direzione in cui le barre crescono lungo l'asse orizzontale. |
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 righe e 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 considerare come intestazioni. |
set | Embedded | Imposta le opzioni avanzate per questo grafico. |
set | Embedded | Imposta la posizione, modificando il punto in cui viene visualizzato il grafico nel foglio. |
set | Embedded | Imposta l'intervallo per il grafico. |
set | Embedded | Utilizza linee in pila, il che significa che i valori delle linee e delle barre sono in pila (accumulati). |
set | Embedded | Imposta il titolo del grafico. |
set | Embedded | Imposta lo stile del testo del titolo del grafico. |
set | Embedded | Specifica se le righe e le colonne del grafico vengono trasposte. |
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 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. |
use | Embedded | Trasforma l'asse dell'intervallo in una scala logaritmica (richiede che tutti i valori siano positivi). |
Documentazione dettagliata
add Range(range)
Aggiunge un intervallo al grafico che questo generatore modifica. 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. |
Indietro
Embedded
: questo generatore, per il concatenamento.
as Area Chart()
Imposta il tipo di grafico su AreaChart e restituisce un Embedded
.
Indietro
Embedded
: un generatore per un grafico ad area.
as Bar Chart()
Imposta il tipo di grafico su BarChart e restituisce un Embedded
.
Indietro
Embedded
: un generatore per un grafico a barre.
as Column Chart()
Imposta il tipo di grafico su ColumnChart e restituisce un Embedded
.
Indietro
Embedded
: un generatore per un grafico a colonne.
as Combo Chart()
Imposta il tipo di grafico su ComboChart e restituisce un Embedded
.
Indietro
Embedded
: un generatore per un grafico combinato.
as Histogram Chart()
Imposta il tipo di grafico su HistogramChart e restituisce un Embedded
.
Indietro
Embedded
: uno strumento di creazione per un istogramma.
as Line Chart()
Imposta il tipo di grafico su LineChart e restituisce un Embedded
.
Indietro
Embedded
: un generatore per un grafico a linee.
as Pie Chart()
Imposta il tipo di grafico su PieChart e restituisce un Embedded
.
Indietro
Embedded
: un generatore per un grafico a torta.
as Scatter Chart()
Imposta il tipo di grafico su ScatterChart e restituisce un Embedded
.
Indietro
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
.
Indietro
Embedded
: un generatore per un grafico a tabella.
build()
Crea il grafico in modo che rifletta 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)
, mentre 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);
Indietro
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);
Indietro
Embedded
: questo generatore, per il concatenamento.
get Chart Type()
get Container()
Restituisce il grafico Container
, che indica la posizione in cui viene visualizzato il grafico 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(), );
Indietro
Container
: un oggetto contenente la posizione del contenitore del grafico.
get Ranges()
Restituisce una copia dell'elenco degli intervalli che forniscono attualmente 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()); }
Indietro
Range[]
: un array di intervalli che funge da origine dati per il grafico da creare.
remove Range(range)
Rimuove l'intervallo specificato dal grafico modificato da questo generatore. Non genera 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 renders 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 // is not removed, and does 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. |
Indietro
Embedded
: questo generatore, per il concatenamento.
reverse Categories()
Inverte il disegno delle serie nell'asse del dominio. Per i grafici a intervallo verticale (come i grafici a linee, ad area o a colonne), l'asse orizzontale viene disegnato da destra a sinistra. Per i grafici a intervalli orizzontali (come i grafici a barre), l'asse verticale viene disegnato dall'alto verso il basso. Per i grafici a torta, significa che le sezioni vengono disegnate in senso antiorario.
// Creates a pie chart builder and sets drawing of the slices in a // counter-clockwise manner. const builder = Charts.newPieChart(); builder.reverseCategories();
Indietro
Embedded
: questo generatore, utile per il concatenamento.
reverse Direction()
Inverte la direzione in cui le barre crescono lungo l'asse orizzontale. Per impostazione predefinita, i valori aumentano da sinistra a destra. La chiamata di questo metodo fa sì che crescano da destra a sinistra.
Indietro
Embedded
: questo generatore, utile per il concatenamento.
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 per il colore (ad esempio "blue" o "#00f" ). |
Indietro
Embedded
: questo generatore, utile per il concatenamento.
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 convertire questo grafico. |
Indietro
Embedded
: questo generatore, per il concatenamento.
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'ennesimo elemento dell'array rappresenta il colore dell'ennesima linea del grafico. |
Indietro
Embedded
: questo generatore, utile per il concatenamento.
set Hidden Dimension Strategy(strategy)
Imposta la strategia da utilizzare per righe e 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 righe e colonne nascoste. |
Indietro
Embedded
: questo generatore, per il concatenamento.
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. |
Indietro
Embedded
: questo generatore, utile per il concatenamento.
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 del testo da utilizzare per la legenda del grafico. |
Indietro
Embedded
: questo generatore, utile per il concatenamento.
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. |
Indietro
Embedded
: questo generatore, per il concatenamento.
set Num Headers(headers)
Imposta il numero di righe o colonne dell'intervallo da considerare 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. |
Indietro
Embedded
: questo generatore, per il concatenamento.
set Option(option, value)
Imposta le opzioni avanzate per questo grafico. Per visualizzare un elenco delle opzioni disponibili, consulta Opzioni di configurazione del grafico.
Questo metodo non convalida che l'opzione specificata sia valida per questo tipo di grafico né che il valore abbia il formato/la 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. |
Indietro
Embedded
: questo generatore, per il concatenamento.
set Position(anchorRowPos, anchorColPos, offsetX, offsetY)
Imposta la posizione, modificando il punto in cui viene visualizzato il grafico nel foglio. anchor
e anchor
sono indicizzati a partire 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 è spostato di questo numero di pixel. |
Indietro
Embedded
: questo generatore, per il concatenamento.
set Range(start, end)
Imposta l'intervallo per il grafico.
Se alcuni punti dati non rientrano nell'intervallo, quest'ultimo viene espanso per includerli.
Parametri
Nome | Tipo | Descrizione |
---|---|---|
start | Number | Il valore della linea della griglia più bassa dell'asse dell'intervallo. |
end | Number | Il valore della linea della griglia più alta dell'asse dell'intervallo. |
Indietro
Embedded
: questo generatore, utile per il concatenamento.
set Stacked()
Utilizza linee in pila, il che significa che i valori delle linee e delle barre sono in pila (accumulati). Per impostazione predefinita, non è presente alcuno stacking.
Indietro
Embedded
: questo generatore, utile per il concatenamento.
set Title(chartTitle)
Imposta il titolo del grafico. Il titolo viene visualizzato centrato 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. |
Indietro
Embedded
: questo generatore, utile per il concatenamento.
set Title Text Style(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 del testo da utilizzare per il titolo del grafico. Puoi creare un oggetto Text chiamando Charts.newTextStyle() . |
Indietro
Embedded
: questo generatore, utile per il concatenamento.
set Transpose Rows And Columns(transpose)
Specifica se le righe e le colonne del grafico vengono 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. |
Indietro
Embedded
: questo generatore, per il concatenamento.
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 del testo da utilizzare per il titolo dell'asse orizzontale. Puoi creare un oggetto Text chiamando Charts.newTextStyle() . |
Indietro
Embedded
: questo generatore, utile per il concatenamento.
set XAxis Title(title)
Aggiunge un titolo all'asse orizzontale. Il titolo è centrato e viene visualizzato sotto le etichette dei valori 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. |
Indietro
Embedded
: questo generatore, utile per il concatenamento.
set XAxis Title Text Style(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 del testo da utilizzare per il titolo dell'asse orizzontale. Puoi creare un oggetto Text chiamando Charts.newTextStyle() . |
Indietro
Embedded
: questo generatore, utile per il concatenamento.
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 del testo da utilizzare per il titolo dell'asse orizzontale. Puoi creare un oggetto Text chiamando Charts.newTextStyle() . |
Indietro
Embedded
: questo generatore, utile per il concatenamento.
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. |
Indietro
Embedded
: questo generatore, utile per il concatenamento.
set YAxis Title Text Style(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 del testo da utilizzare per il titolo dell'asse orizzontale. Puoi creare un oggetto Text chiamando Charts.newTextStyle() . |
Indietro
Embedded
: questo generatore, utile per il concatenamento.
use Log Scale()
Trasforma l'asse dell'intervallo in una scala logaritmica (richiede che tutti i valori siano positivi). L'asse dell'intervallo è l'asse verticale per i grafici verticali (come a linee, ad area o a colonne) e l'asse orizzontale per i grafici orizzontali (come a barre).
Indietro
Embedded
: questo generatore, utile per il concatenamento.