Strumento utilizzato per modificare un Embedded
. Le modifiche apportate al grafico non vengono salvate finché non viene chiamato Sheet.updateChart(chart)
sul grafico ricostruito.
const sheet = SpreadsheetApp.getActiveSheet(); const range = sheet.getRange('A1:B8'); let 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);
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 | Modifica il tipo di grafico. |
set | Embedded | Imposta la strategia da utilizzare per le righe e le colonne nascoste. |
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 se le righe e le colonne del grafico devono essere trasposte. |
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 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 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 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 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 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 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 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