Class EmbeddedTableChartBuilder

Aggiunge un intervallo al grafico che questo generatore modifica. 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

Indietro

EmbeddedChartBuilder: questo generatore, per il concatenamento.

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

Indietro

EmbeddedAreaChartBuilder: un generatore per un grafico ad area.

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

Indietro

EmbeddedBarChartBuilder: un generatore per un grafico a barre.

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

Indietro

EmbeddedColumnChartBuilder: un generatore per un grafico a colonne.

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

Indietro

EmbeddedComboChartBuilder: un generatore per un grafico combinato.

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

Indietro

EmbeddedHistogramChartBuilder: uno strumento di creazione per un istogramma.

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

Indietro

EmbeddedLineChartBuilder: un generatore per un grafico a linee.

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

Indietro

EmbeddedPieChartBuilder: un generatore per un grafico a torta.

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

Indietro

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

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

Indietro

EmbeddedTableChartBuilder: un generatore per un grafico a tabella.

Crea il grafico in modo che rifletta 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), mentre 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);

Indietro

EmbeddedChart: il grafico creato, che deve ancora essere aggiunto al foglio di lavoro.

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);

Indietro

EmbeddedChartBuilder: questo generatore, per il concatenamento.

Consente di stabilire se attivare la paginazione dei dati.

Il comportamento predefinito prevede la paginazione disattivata. Se la paginazione è abilitata, le dimensioni predefinite della pagina sono 10.

Parametri

Indietro

EmbeddedTableChartBuilder: questo generatore, utile per il concatenamento.

Attiva la paginazione 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. const builder = Charts.newTableChart(); builder.enablePaging(5);

Parametri

Indietro

EmbeddedTableChartBuilder: questo generatore, utile per il concatenamento.

Attiva la paginazione, imposta il numero di righe in ogni pagina e la prima pagina della tabella da visualizzare (i numeri di pagina sono basati su zero).

La dimensione pagina predefinita è 10 e la pagina iniziale predefinita è 0.

// Creates a table chart builder and enables paging with page size of 5 and // displays page 2 first. const builder = Charts.newTableChart(); builder.enablePaging(5, 2);

Parametri

Indietro

EmbeddedTableChartBuilder: questo generatore, utile per il concatenamento.

Aggiunge il supporto di base per le lingue da destra a sinistra (come arabo o 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 la colonna più a sinistra.

Ciò non influisce sull'indice delle colonne nei dati sottostanti, ma solo sull'ordine di visualizzazione. La visualizzazione completa delle lingue bidirezionali non è supportata dalla visualizzazione della tabella anche con questa opzione. Questa opzione viene ignorata se attivi la paginazione (utilizzando l'opzione Pagina) o se la tabella ha barre di scorrimento perché hai specificato opzioni di altezza e larghezza inferiori alle dimensioni della tabella richieste. Il comportamento predefinito prevede il supporto RTL disattivato.

Parametri

Indietro

EmbeddedTableChartBuilder: questo generatore, utile per il concatenamento.

Imposta 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 della colonna, le righe vengono ordinate automaticamente. Il comportamento predefinito è l'ordinamento abilitato.

Parametri

Indietro

EmbeddedTableChartBuilder: questo generatore, utile per il concatenamento.

Restituisce il tipo di grafico corrente.

Indietro

ChartType: il tipo di grafico.

Restituisce il grafico ContainerInfo, che indica la posizione in cui viene visualizzato il grafico 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(), );

Indietro

ContainerInfo: un oggetto contenente la posizione del contenitore del grafico.

Restituisce una copia dell'elenco degli intervalli che forniscono attualmente 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()); }

Indietro

Range[]: un array di intervalli che funge da origine dati per il grafico da creare.

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 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 renders 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 // is not removed, and does not throw an exception chartBuilder.removeRange(firstRange); chartBuilder.removeRange(sheet.getRange('A6:B8'));  const chart = chartBuilder.build();  sheet.insertChart(chart);

Parametri

Indietro

EmbeddedChartBuilder: questo generatore, per il concatenamento.

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

Indietro

EmbeddedChartBuilder: questo generatore, per il concatenamento.

Imposta il numero di riga per la prima riga nella tabella dei dati.

Il numero di riga predefinito della prima riga è 1.

// Creates a table chart builder and sets the first row to be 2. const builder = Charts.newTableChart(); builder.setFirstRowNumber(2);

Parametri

Indietro

EmbeddedTableChartBuilder: questo generatore, utile per il concatenamento.

Imposta la strategia da utilizzare per righe e 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

Indietro

EmbeddedChartBuilder: questo generatore, per il concatenamento.

Imposta l'indice della colonna in base alla quale la tabella deve essere inizialmente ordinata (in ordine crescente).

La colonna è ordinata in ordine crescente ed è contrassegnata da una piccola freccia che lo indica.

// Creates a table chart builder and sorts it by the second column (ascending). const builder = Charts.newTableChart(); builder.setInitialSortingAscending(2);

Parametri

Indietro

EmbeddedTableChartBuilder: questo generatore, utile per il concatenamento.

Imposta l'indice della colonna in base alla quale la tabella deve essere inizialmente ordinata (in ordine decrescente).

La colonna è ordinata in ordine decrescente ed è contrassegnata da una piccola freccia che lo indica.

// Creates a table chart builder and sorts it by the second column (descending). const builder = Charts.newTableChart(); builder.setInitialSortingDescending(2);

Parametri

Indietro

EmbeddedTableChartBuilder: questo generatore, utile per il concatenamento.

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

Indietro

EmbeddedChartBuilder: questo generatore, per il concatenamento.

Imposta il numero di righe o colonne dell'intervallo da considerare 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

Indietro

EmbeddedChartBuilder: questo generatore, per il concatenamento.

Imposta le opzioni avanzate per questo grafico. Per visualizzare un elenco delle opzioni disponibili, consulta Opzioni di configurazione del grafico.

Questo metodo non convalida che l'opzione specificata sia valida per questo tipo di grafico né che il valore abbia il formato/la 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

Indietro

EmbeddedChartBuilder: questo generatore, per il concatenamento.

Imposta la posizione, modificando il punto in cui viene visualizzato il grafico nel foglio. anchorRowPos e anchorColPos sono indicizzati a partire 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

Indietro

EmbeddedChartBuilder: questo generatore, per il concatenamento.

Specifica 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.

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

Indietro

EmbeddedChartBuilder: questo generatore, per il concatenamento.

Imposta se mostrare il numero di riga come prima colonna della tabella.

Il comportamento predefinito non prevede la visualizzazione dei numeri di riga.

Parametri

Indietro

EmbeddedTableChartBuilder: questo generatore, utile per il concatenamento.

Imposta se lo stile di colore alternato viene assegnato alle righe pari e dispari di un grafico a tabella.

Il comportamento predefinito prevede che le righe abbiano uno stile di colore alternato.

Parametri

Indietro

EmbeddedTableChartBuilder: questo generatore, utile per il concatenamento.