Strumento per la creazione di grafici a tabella. Per ulteriori dettagli, consulta la documentazione di Gviz.
Metodi
Metodo | Tipo restituito | Breve descrizione |
---|---|---|
addRange(range) | EmbeddedChartBuilder | Aggiunge un intervallo al grafico modificato da questo generatore. |
asAreaChart() | EmbeddedAreaChartBuilder | Imposta il tipo di grafico su AreaChart e restituisce EmbeddedAreaChartBuilder . |
asBarChart() | EmbeddedBarChartBuilder | Imposta il tipo di grafico su Grafico a barre e restituisce un EmbeddedBarChartBuilder . |
asColumnChart() | EmbeddedColumnChartBuilder | Imposta il tipo di grafico su ColumnChart e restituisce un EmbeddedColumnChartBuilder . |
asComboChart() | EmbeddedComboChartBuilder | Imposta il tipo di grafico su ComboChart e restituisce EmbeddedComboChartBuilder . |
asHistogramChart() | EmbeddedHistogramChartBuilder | Imposta il tipo di grafico su IstogramChart e restituisce un EmbeddedHistogramChartBuilder . |
asLineChart() | EmbeddedLineChartBuilder | Imposta il tipo di grafico su LineChart e restituisce EmbeddedLineChartBuilder . |
asPieChart() | EmbeddedPieChartBuilder | Imposta il tipo di grafico su Grafico a torta e restituisce un EmbeddedPieChartBuilder . |
asScatterChart() | EmbeddedScatterChartBuilder | Imposta il tipo di grafico su Grafico a dispersione e restituisce un valore EmbeddedScatterChartBuilder . |
asTableChart() | EmbeddedTableChartBuilder | Imposta il tipo di grafico su TableChart e restituisce EmbeddedTableChartBuilder . |
build() | EmbeddedChart | Crea il grafico per riflettere tutte le modifiche apportate. |
clearRanges() | EmbeddedChartBuilder | Rimuove tutti gli intervalli dal grafico modificato da questo generatore. |
enablePaging(enablePaging) | EmbeddedTableChartBuilder | Consente di impostare se attivare il paging tra i dati. |
enablePaging(pageSize) | EmbeddedTableChartBuilder | Abilita il paging e imposta il numero di righe in ogni pagina. |
enablePaging(pageSize, startPage) | EmbeddedTableChartBuilder | Abilita il paging, imposta il numero di righe in ogni pagina e la prima pagina della tabella da visualizzare (i numeri di pagina sono in base zero). |
enableRtlTable(rtlEnabled) | EmbeddedTableChartBuilder | Aggiunge il supporto di base per le lingue con orientamento da destra a sinistra (come l'arabo o l'ebraico) invertendo l'ordine delle colonne della tabella, in modo che la colonna zero sia la colonna più a destra e l'ultima colonna sia quella più a sinistra. |
enableSorting(enableSorting) | EmbeddedTableChartBuilder | Consente di scegliere se ordinare le colonne quando l'utente fa clic su un'intestazione di colonna. |
getChartType() | ChartType | Restituisce il tipo di grafico corrente. |
getContainer() | ContainerInfo | Restituisce il grafico ContainerInfo , che racchiude il punto in cui viene visualizzato sul foglio. |
getRanges() | Range[] | Restituisce una copia dell'elenco di intervalli che attualmente forniscono dati per questo grafico. |
removeRange(range) | EmbeddedChartBuilder | Rimuove l'intervallo specificato dal grafico modificato da questo generatore. |
setChartType(type) | EmbeddedChartBuilder | Modifica il tipo di grafico. |
setFirstRowNumber(number) | EmbeddedTableChartBuilder | Imposta il numero di riga per la prima riga nella tabella di dati. |
setHiddenDimensionStrategy(strategy) | EmbeddedChartBuilder | Imposta la strategia da utilizzare per righe e colonne nascoste. |
setInitialSortingAscending(column) | EmbeddedTableChartBuilder | Imposta l'indice della colonna in base al quale la tabella dovrebbe essere ordinata inizialmente (ordine crescente). |
setInitialSortingDescending(column) | EmbeddedTableChartBuilder | Imposta l'indice della colonna in base al quale la tabella deve essere ordinata inizialmente (decrescente). |
setMergeStrategy(mergeStrategy) | EmbeddedChartBuilder | Imposta la strategia di unione da utilizzare quando esiste più di un intervallo. |
setNumHeaders(headers) | EmbeddedChartBuilder | Imposta il numero di righe o colonne dell'intervallo che devono essere trattate come intestazioni. |
setOption(option, value) | EmbeddedChartBuilder | Imposta le opzioni avanzate per questo grafico. |
setPosition(anchorRowPos, anchorColPos, offsetX, offsetY) | EmbeddedChartBuilder | Imposta la posizione, modificando il punto in cui viene visualizzato il grafico sul foglio. |
setTransposeRowsAndColumns(transpose) | EmbeddedChartBuilder | Consente di impostare se le righe e le colonne del grafico vengono trasposte. |
showRowNumberColumn(showRowNumber) | EmbeddedTableChartBuilder | Consente di impostare se mostrare il numero di riga come prima colonna della tabella. |
useAlternatingRowStyle(alternate) | EmbeddedTableChartBuilder | Consente di impostare se lo stile di colore alternato viene assegnato alle righe pari e dispari di un grafico tabella. |
Documentazione dettagliata
addRange(range)
Aggiunge un intervallo al grafico modificato da questo generatore. Non aggiunge l'intervallo se è già stato aggiunto al grafico.
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(); sheet.insertChart(chart);
Parametri
Nome | Tipo | Descrizione |
---|---|---|
range | Range | L'intervallo da aggiungere. |
Ritorni
EmbeddedChartBuilder
- questo generatore, per il concatenamento
asAreaChart()
Imposta il tipo di grafico su AreaChart e restituisce EmbeddedAreaChartBuilder
.
Ritorni
EmbeddedAreaChartBuilder
: uno strumento per la creazione di un grafico ad area
asBarChart()
Imposta il tipo di grafico su Grafico a barre e restituisce un EmbeddedBarChartBuilder
.
Ritorni
EmbeddedBarChartBuilder
: uno strumento per la creazione di un grafico a barre
asColumnChart()
Imposta il tipo di grafico su ColumnChart e restituisce un EmbeddedColumnChartBuilder
.
Ritorni
EmbeddedColumnChartBuilder
: uno strumento per la creazione di un grafico a colonne
asComboChart()
Imposta il tipo di grafico su ComboChart e restituisce EmbeddedComboChartBuilder
.
Ritorni
EmbeddedComboChartBuilder
: uno strumento per la creazione di un grafico combinato
asHistogramChart()
Imposta il tipo di grafico su IstogramChart e restituisce un EmbeddedHistogramChartBuilder
.
Ritorni
EmbeddedHistogramChartBuilder
: uno strumento per la creazione di un grafico a istogrammi
asLineChart()
Imposta il tipo di grafico su LineChart e restituisce EmbeddedLineChartBuilder
.
Ritorni
EmbeddedLineChartBuilder
: uno strumento per la creazione di un grafico a linee
asPieChart()
Imposta il tipo di grafico su Grafico a torta e restituisce un EmbeddedPieChartBuilder
.
Ritorni
EmbeddedPieChartBuilder
: uno strumento per la creazione di un grafico a torta
asScatterChart()
Imposta il tipo di grafico su Grafico a dispersione e restituisce un valore EmbeddedScatterChartBuilder
.
Ritorni
EmbeddedScatterChartBuilder
: uno strumento per la creazione di un grafico a dispersione
asTableChart()
Imposta il tipo di grafico su TableChart e restituisce EmbeddedTableChartBuilder
.
Ritorni
EmbeddedTableChartBuilder
: uno strumento per la creazione di un grafico a tabella
build()
Crea il grafico per riflettere tutte le modifiche apportate.
Questo metodo non consente di disegnare automaticamente il grafico nella parte superiore del foglio di lavoro. È necessario inserire un nuovo grafico tramite sheet.insertChart(chart)
e aggiornarne uno esistente tramite sheet.updateChart(chart)
.
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) .setPosition(5, 5, 0, 0) .build(); sheet.insertChart(chart);
Ritorni
EmbeddedChart
: il grafico creato, che deve essere comunque aggiunto al foglio di lavoro.
clearRanges()
Rimuove tutti gli intervalli dal grafico modificato da questo generatore.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // This code updates the chart to use only the new ranges while preserving the existing // formatting of the chart. var chart = sheet.getCharts()[0]; var newChart = chart .modify() .clearRanges() .addRange(sheet.getRange("A1:A5")) .addRange(sheet.getRange("B1:B5")) .build(); sheet.updateChart(newChart);
Ritorni
EmbeddedChartBuilder
- questo generatore, per il concatenamento
enablePaging(enablePaging)
Consente di impostare se attivare il paging tra i dati.
Il comportamento predefinito è il paging disabilitato. Se il paging è attivato, la dimensione predefinita della pagina è 10.
Parametri
Nome | Tipo | Descrizione |
---|---|---|
enablePaging | Boolean | true se deve essere attivato il paging, false in caso contrario. |
Ritorni
EmbeddedTableChartBuilder
: questo builder, utile per il concatenamento.
enablePaging(pageSize)
Abilita il paging e imposta il numero di righe in ogni pagina.
La dimensione predefinita della pagina è 10.
// Creates a table chart builder and enables paging with page size of 5. var builder = Charts.newTableChart(); builder.enablePaging(5);
Parametri
Nome | Tipo | Descrizione |
---|---|---|
pageSize | Integer | Il numero di righe in ogni pagina della tabella. |
Ritorni
EmbeddedTableChartBuilder
: questo builder, utile per il concatenamento.
enablePaging(pageSize, startPage)
Abilita il paging, imposta il numero di righe in ogni pagina e la prima pagina della tabella da visualizzare (i numeri di pagina sono in base zero).
La dimensione predefinita della pagina è 10, mentre la pagina iniziale è 0.
// Creates a table chart builder and enables paging with page size of 5 and displays page 2 // first. var builder = Charts.newTableChart(); builder.enablePaging(5, 2);
Parametri
Nome | Tipo | Descrizione |
---|---|---|
pageSize | Integer | Il numero di righe in ogni pagina della tabella. |
startPage | Integer | La prima pagina della tabella da visualizzare (i numeri di pagina sono in base zero). |
Ritorni
EmbeddedTableChartBuilder
: questo builder, utile per il concatenamento.
enableRtlTable(rtlEnabled)
Aggiunge il supporto di base per le lingue con orientamento da destra a sinistra (come l'arabo o l'ebraico) invertendo l'ordine delle colonne della tabella, in modo che la colonna zero sia la colonna più a destra e l'ultima colonna sia quella più a sinistra.
Ciò non influisce sull'indice della colonna nei dati sottostanti, ma solo sull'ordine di visualizzazione. La visualizzazione della lingua Bidirezionale completa (BiDi) non è supportata dalla visualizzazione tabulare anche con questa opzione. Questa opzione viene ignorata se attivi il paging (utilizzando l'opzione Pagina) o se la tabella presenta barre di scorrimento perché hai specificato opzioni di altezza e larghezza inferiori alle dimensioni richieste per la tabella. Il comportamento predefinito è il supporto RTL disattivato.
Parametri
Nome | Tipo | Descrizione |
---|---|---|
rtlEnabled | Boolean | true se è necessario attivare il supporto da destra a sinistra, false
in caso contrario. |
Ritorni
EmbeddedTableChartBuilder
: questo builder, utile per il concatenamento.
enableSorting(enableSorting)
Consente di scegliere se ordinare le colonne quando l'utente fa clic su un'intestazione di colonna.
Se l'ordinamento è attivato, quando gli utenti fanno clic sull'intestazione di colonna, le righe vengono ordinate automaticamente. Il comportamento predefinito è l'ordinamento abilitato.
Parametri
Nome | Tipo | Descrizione |
---|---|---|
enableSorting | Boolean | true per attivare l'ordinamento facendo clic sulle intestazioni di colonna, altrimenti false . |
Ritorni
EmbeddedTableChartBuilder
: questo builder, utile per il concatenamento.
getChartType()
getContainer()
Restituisce il grafico ContainerInfo
, che racchiude il punto in cui viene visualizzato sul foglio.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var 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() var containerInfo = chartBuilder.getContainer(); // 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
getRanges()
Restituisce una copia dell'elenco di intervalli che attualmente forniscono dati per questo grafico. Utilizza addRange(range)
e removeRange(range)
per modificare questo elenco.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var chartBuilder = sheet.newChart() .setChartType(Charts.ChartType.BAR) .addRange(sheet.getRange("A1:B8")) .setPosition(5, 5, 0, 0); var ranges = chartBuilder.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 grafico da creare come origine dati
removeRange(range)
Rimuove l'intervallo specificato dal grafico modificato da questo generatore. Non genera un errore se l'intervallo non è in questo grafico.
L'intervallo rimosso deve corrispondere a un intervallo aggiunto tramite addRange(range)
; in caso contrario non viene apportata alcuna modifica al grafico. Questo metodo non può essere utilizzato per rimuovere parzialmente
i valori da un intervallo.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var firstRange = sheet.getRange("A1:B5"); var secondRange = sheet.getRange("A6:B8"); var 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")); var chart = chartBuilder.build(); sheet.insertChart(chart);
Parametri
Nome | Tipo | Descrizione |
---|---|---|
range | Range | L'intervallo da rimuovere. |
Ritorni
EmbeddedChartBuilder
- questo generatore, per il concatenamento
setChartType(type)
Modifica il tipo di grafico. Al momento non sono supportati tutti i tipi di grafici incorporati. Leggi i ChartType
.
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) .setPosition(5, 5, 0, 0) .build(); sheet.insertChart(chart);
Parametri
Nome | Tipo | Descrizione |
---|---|---|
type | ChartType | Il tipo in cui modificare questo grafico. |
Ritorni
EmbeddedChartBuilder
- questo generatore, per il concatenamento
setFirstRowNumber(number)
Imposta il numero di riga per la prima riga nella tabella di dati.
Il numero predefinito della prima riga è 1.
// Creates a table chart builder and sets the first row to be 2. var builder = Charts.newTableChart(); builder.setFirstRowNumber(2);
Parametri
Nome | Tipo | Descrizione |
---|---|---|
number | Integer | Il numero di riga per la prima riga nella tabella di dati. |
Ritorni
EmbeddedTableChartBuilder
: questo builder, utile per il concatenamento.
setHiddenDimensionStrategy(strategy)
Imposta la strategia da utilizzare per 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(); sheet.insertChart(chart);
Parametri
Nome | Tipo | Descrizione |
---|---|---|
strategy | ChartHiddenDimensionStrategy | La strategia da utilizzare per righe e colonne nascoste. |
Ritorni
EmbeddedChartBuilder
- questo generatore, per il concatenamento
setInitialSortingAscending(column)
Imposta l'indice della colonna in base al quale la tabella dovrebbe essere ordinata inizialmente (ordine crescente).
Il sistema operativo della colonna è ordinato in ordine crescente ed è contrassegnato da una piccola freccia che lo indica.
// Creates a table chart builder and sorts it by the second column (ascending). var builder = Charts.newTableChart(); builder.setInitialSortingAscending(2);
Parametri
Nome | Tipo | Descrizione |
---|---|---|
column | Integer | Il numero della colonna in base alla quale deve essere ordinata inizialmente la tabella. |
Ritorni
EmbeddedTableChartBuilder
: questo builder, utile per il concatenamento.
setInitialSortingDescending(column)
Imposta l'indice della colonna in base al quale la tabella deve essere ordinata inizialmente (decrescente).
Il sistema operativo della colonna è ordinato in ordine decrescente ed è contrassegnato da una piccola freccia che lo indica.
// Creates a table chart builder and sorts it by the second column (descending). var builder = Charts.newTableChart(); builder.setInitialSortingDescending(2);
Parametri
Nome | Tipo | Descrizione |
---|---|---|
column | Integer | Il numero della colonna in base alla quale deve essere ordinata inizialmente la tabella. |
Ritorni
EmbeddedTableChartBuilder
: questo builder, utile per il concatenamento.
setMergeStrategy(mergeStrategy)
Imposta la strategia di unione da utilizzare 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("C:C10"); var 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 |
---|---|---|
mergeStrategy | ChartMergeStrategy | La strategia di unione da utilizzare. |
Ritorni
EmbeddedChartBuilder
- questo generatore, per il concatenamento
setNumHeaders(headers)
Imposta il numero di righe o colonne dell'intervallo che devono essere 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(); sheet.insertChart(chart);
Parametri
Nome | Tipo | Descrizione |
---|---|---|
headers | Integer | Il numero di righe o colonne da considerare come intestazioni. I valori negativi determinano il rilevamento automatico delle intestazioni. |
Ritorni
EmbeddedChartBuilder
- questo generatore, per il concatenamento
setOption(option, value)
Imposta le opzioni avanzate per questo grafico. Per visualizzare un elenco delle opzioni disponibili, vedi Opzioni di configurazione dei grafici.
Questo metodo non convalida che l'opzione specificata sia valida per questo tipo di grafico né se il valore abbia il formato/la struttura corretta.
Questo esempio mostra come modificare il titolo e impostare una legenda.
builder.setOption('title', 'Earnings projections'); builder.setOption('legend', {position: 'top', textStyle: {color: 'blue', fontSize: 16}});
Parametri
Nome | Tipo | Descrizione |
---|---|---|
option | String | Il nome dell'opzione. |
value | Object | Il valore dell'opzione. |
Ritorni
EmbeddedChartBuilder
- Questo builder, per il concatenamento.
setPosition(anchorRowPos, anchorColPos, offsetX, offsetY)
Imposta la posizione, modificando il punto in cui viene visualizzato il grafico sul foglio. anchorRowPos
e
anchorColPos
hanno un indice indicizzato di 1.
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) .setPosition(5, 5, 0, 0) .build(); sheet.insertChart(chart);
Parametri
Nome | Tipo | Descrizione |
---|---|---|
anchorRowPos | Integer | Il lato superiore del grafico è ancorato a questa riga. |
anchorColPos | Integer | Il lato sinistro del grafico è ancorato a questa colonna. |
offsetX | Integer | L'angolo in alto a destra del grafico è offset da questo numero di pixel. |
offsetY | Integer | L'angolo inferiore sinistro del grafico è offset da questo numero di pixel. |
Ritorni
EmbeddedChartBuilder
- questo generatore, per il concatenamento
setTransposeRowsAndColumns(transpose)
Consente di impostare 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
.
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) .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 costruire il grafico vengono trasposte. |
Ritorni
EmbeddedChartBuilder
- questo generatore, per il concatenamento
showRowNumberColumn(showRowNumber)
Consente di impostare se mostrare il numero di riga come prima colonna della tabella.
Il comportamento predefinito non mostra i numeri di riga.
Parametri
Nome | Tipo | Descrizione |
---|---|---|
showRowNumber | Boolean | true se la prima colonna della tabella deve mostrare il numero di riga,
false in caso contrario. |
Ritorni
EmbeddedTableChartBuilder
: questo builder, utile per il concatenamento.
useAlternatingRowStyle(alternate)
Consente di impostare se lo stile di colore alternato viene assegnato alle righe pari e dispari di un grafico tabella.
Il comportamento predefinito è che le righe hanno uno stile di colore alternato.
Parametri
Nome | Tipo | Descrizione |
---|---|---|
alternate | Boolean | true se gli stili di colore devono alternare, false in caso contrario. |
Ritorni
EmbeddedTableChartBuilder
: questo builder, utile per il concatenamento.