Builder utilizzato per modificare un EmbeddedChart
. Le modifiche apportate al grafico non vengono salvate fino a quando Sheet.updateChart(chart)
non viene richiamato nel grafico ricreato.
var sheet = SpreadsheetApp.getActiveSheet(); var range = sheet.getRange("A1:B8"); var 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 |
---|---|---|
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. |
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. |
setHiddenDimensionStrategy(strategy) | EmbeddedChartBuilder | Imposta la strategia da utilizzare per righe e colonne nascoste. |
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. |
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
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
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
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