Generatore di grafici a barre. 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. |
reverse | Embedded | Inverte il disegno delle serie nell'asse del dominio. |
reverse | Embedded | Inverte la direzione di crescita delle barre 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 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 la posizione, modificando la posizione del 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 | Imposta se le righe e le colonne del grafico devono essere 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 | Imposta l'asse di intervallo su una scala logaritmica (è necessario che tutti i valori siano positivi). |
Documentazione dettagliata
addRange(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
asAreaChart()
Imposta il tipo di grafico su AreaChart e restituisce un Embedded
.
Invio
Embedded
: uno strumento per la creazione di un grafico ad area
asBarChart()
Imposta il tipo di grafico su BarChart e restituisce un Embedded
.
Invio
Embedded
: uno strumento per la creazione di un grafico a barre
asColumnChart()
Imposta il tipo di grafico su ColumnChart e restituisce un Embedded
.
Invio
Embedded
: uno strumento per la creazione di un grafico a colonne
asComboChart()
Imposta il tipo di grafico su ComboChart e restituisce un Embedded
.
Invio
Embedded
: uno strumento per la creazione di un grafico combinato
asHistogramChart()
Imposta il tipo di grafico su HistogramChart e restituisce un Embedded
.
Invio
Embedded
: uno strumento per la creazione di un istogramma
asLineChart()
Imposta il tipo di grafico su LineChart e restituisce un Embedded
.
Invio
Embedded
: un generatore di grafici a linee
asPieChart()
Imposta il tipo di grafico su PieChart e restituisce un Embedded
.
Invio
Embedded
: uno strumento per la creazione di un grafico a torta
asScatterChart()
Imposta il tipo di grafico su ScatterChart e restituisce un Embedded
.
Invio
Embedded
: uno strumento per la creazione di un grafico a dispersione
asTableChart()
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
clearRanges()
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
getChartType()
getContainer()
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
getRanges()
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
removeRange(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
reverseCategories()
Inverte il disegno delle serie nell'asse del dominio. Per i grafici con intervallo verticale (ad es. grafici a linee, a aree o a colonne), l'asse orizzontale viene tracciato da destra a sinistra. Per i grafici con intervalli orizzontali (ad es. i grafici a barre), l'asse verticale viene tracciato 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();
Invio
Embedded
: questo builder è utile per l'accodamento.
reverseDirection()
Inverte la direzione di crescita delle barre lungo l'asse orizzontale. Per impostazione predefinita, i valori aumentano da sinistra a destra. La chiamata di questo metodo ne causa l'aumento da destra a sinistra.
Invio
Embedded
: questo builder è utile per l'accodamento.
setBackgroundColor(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.
setChartType(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
setColors(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.
setHiddenDimensionStrategy(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
setLegendPosition(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.
setLegendTextStyle(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.
setMergeStrategy(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
setNumHeaders(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
setOption(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.
setPosition(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
setRange(start, end)
Imposta l'intervallo per il grafico.
Se alcuni punti dati non rientrano nell'intervallo, questo viene espanso in modo da includerli.
Parametri
Nome | Tipo | Descrizione |
---|---|---|
start | Number | Il valore della riga della griglia più bassa dell'asse intervallo. |
end | Number | Il valore della linea di griglia più alta dell'asse intervallo. |
Invio
Embedded
: questo builder è utile per l'accodamento.
setStacked()
Utilizza linee in pila, il che significa che i valori delle linee e delle barre sono in pila (accumulati). Per impostazione predefinita, non è presente l'accatastamento.
Invio
Embedded
: questo builder è utile per l'accodamento.
setTitle(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.
setTitleTextStyle(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.
setTransposeRowsAndColumns(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
setXAxisTextStyle(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.
setXAxisTitle(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.
setXAxisTitleTextStyle(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.
setYAxisTextStyle(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.
setYAxisTitle(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.
setYAxisTitleTextStyle(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.
useLogScale()
Imposta l'asse di intervallo su una scala logaritmica (è necessario che tutti i valori siano positivi). L'asse intervallo è l'asse verticale per i grafici verticali (ad es. a linee, ad area o a colonne) e l'asse orizzontale per i grafici orizzontali (ad es. a barre).
Invio
Embedded
: questo builder è utile per l'accodamento.