Questa pagina è stata tradotta dall'API Cloud Translation.

Class EmbeddedChartBuilder

Strumento utilizzato per modificare un EmbeddedChart. 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
`addRange(range)`	`EmbeddedChartBuilder`	Aggiunge un intervallo al grafico modificato da questo generatore.
`asAreaChart()`	`EmbeddedAreaChartBuilder`	Imposta il tipo di grafico su AreaChart e restituisce un `EmbeddedAreaChartBuilder`.
`asBarChart()`	`EmbeddedBarChartBuilder`	Imposta il tipo di grafico su BarChart 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 un `EmbeddedComboChartBuilder`.
`asHistogramChart()`	`EmbeddedHistogramChartBuilder`	Imposta il tipo di grafico su HistogramChart e restituisce un `EmbeddedHistogramChartBuilder`.
`asLineChart()`	`EmbeddedLineChartBuilder`	Imposta il tipo di grafico su LineChart e restituisce un `EmbeddedLineChartBuilder`.
`asPieChart()`	`EmbeddedPieChartBuilder`	Imposta il tipo di grafico su PieChart e restituisce un `EmbeddedPieChartBuilder`.
`asScatterChart()`	`EmbeddedScatterChartBuilder`	Imposta il tipo di grafico su ScatterChart e restituisce un `EmbeddedScatterChartBuilder`.
`asTableChart()`	`EmbeddedTableChartBuilder`	Imposta il tipo di grafico su TableChart e restituisce un `EmbeddedTableChartBuilder`.
`build()`	`EmbeddedChart`	Il grafico viene creato in modo da 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 la posizione in cui il grafico viene visualizzato nel foglio.
`getRanges()`	`Range[]`	Restituisce una copia dell'elenco degli intervalli che attualmente forniscono i 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 le righe e le 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 da trattare come intestazioni.
`setOption(option, value)`	`EmbeddedChartBuilder`	Imposta le opzioni avanzate per questo grafico.
`setPosition(anchorRowPos, anchorColPos, offsetX, offsetY)`	`EmbeddedChartBuilder`	Imposta la posizione, modificando la posizione del grafico nel foglio.
`setTransposeRowsAndColumns(transpose)`	`EmbeddedChartBuilder`	Imposta se le righe e le colonne del grafico devono essere trasposte.

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

EmbeddedChartBuilder: questo generatore, per l'accodamento

`asAreaChart()`

Imposta il tipo di grafico su AreaChart e restituisce un EmbeddedAreaChartBuilder.

Invio

EmbeddedAreaChartBuilder: uno strumento per la creazione di un grafico ad area

`asBarChart()`

Imposta il tipo di grafico su BarChart e restituisce un EmbeddedBarChartBuilder.

Invio

EmbeddedBarChartBuilder: uno strumento per la creazione di un grafico a barre

`asColumnChart()`

Imposta il tipo di grafico su ColumnChart e restituisce un EmbeddedColumnChartBuilder.

Invio

EmbeddedColumnChartBuilder: uno strumento per la creazione di un grafico a colonne

`asComboChart()`

Imposta il tipo di grafico su ComboChart e restituisce un EmbeddedComboChartBuilder.

Invio

EmbeddedComboChartBuilder: uno strumento per la creazione di un grafico combinato

`asHistogramChart()`

Imposta il tipo di grafico su HistogramChart e restituisce un EmbeddedHistogramChartBuilder.

Invio

EmbeddedHistogramChartBuilder: uno strumento per la creazione di un istogramma

`asLineChart()`

Imposta il tipo di grafico su LineChart e restituisce un EmbeddedLineChartBuilder.

Invio

EmbeddedLineChartBuilder: un generatore di grafici a linee

`asPieChart()`

Imposta il tipo di grafico su PieChart e restituisce un EmbeddedPieChartBuilder.

Invio

EmbeddedPieChartBuilder: uno strumento per la creazione di un grafico a torta

`asScatterChart()`

Imposta il tipo di grafico su ScatterChart e restituisce un EmbeddedScatterChartBuilder.

Invio

EmbeddedScatterChartBuilder: uno strumento per la creazione di un grafico a dispersione

`asTableChart()`

Imposta il tipo di grafico su TableChart e restituisce un EmbeddedTableChartBuilder.

Invio

EmbeddedTableChartBuilder: 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

EmbeddedChart: 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

EmbeddedChartBuilder: questo generatore, per l'accodamento

`getChartType()`

Restituisce il tipo di grafico corrente.

Invio

ChartType: il tipo di grafico

`getContainer()`

Restituisce il grafico ContainerInfo, 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

ContainerInfo: 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 addRange(range) e removeRange(range) 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 addRange(range); 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

EmbeddedChartBuilder: questo generatore, per l'accodamento

`setChartType(type)`

Modifica il tipo di grafico. Al momento non tutti i tipi di grafici incorporati sono supportati. Leggi i ChartType.

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`	`ChartType`	Il tipo in cui modificare il grafico.

Invio

EmbeddedChartBuilder: questo generatore, 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`	`ChartHiddenDimensionStrategy`	La strategia da utilizzare per le righe e le colonne nascoste.

Invio

EmbeddedChartBuilder: questo generatore, 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
`mergeStrategy`	`ChartMergeStrategy`	La strategia di unione da utilizzare.

Invio

EmbeddedChartBuilder: 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

EmbeddedChartBuilder: 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

EmbeddedChartBuilder: questo generatore, per l'accodamento.

`setPosition(anchorRowPos, anchorColPos, offsetX, offsetY)`

Imposta la posizione, modificando la posizione del grafico nel foglio. anchorRowPos e anchorColPos 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
`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 è spostato di questo numero di pixel.
`offsetY`	`Integer`	L'angolo in basso a sinistra del grafico è offset di questo numero di pixel.

Invio

EmbeddedChartBuilder: questo generatore, 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

EmbeddedChartBuilder: questo generatore, per l'accodamento