Class EmbeddedTableChartBuilder

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

Invio

EmbeddedChartBuilder: questo generatore, per l'accodamento

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

Invio

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

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

Invio

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

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

Invio

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

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

Invio

EmbeddedComboChartBuilder: uno strumento per la creazione di un grafico combinato

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

Invio

EmbeddedHistogramChartBuilder: uno strumento per la creazione di un istogramma

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

Invio

EmbeddedLineChartBuilder: un generatore di grafici a linee

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

Invio

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

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

Invio

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

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

Invio

EmbeddedTableChartBuilder: uno strumento per la creazione di un grafico a tabella

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

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

Consente di stabilire se attivare la paginazione dei dati.

Il comportamento predefinito è la disattivazione della paginazione. Se l'impaginazione è attivata, le dimensioni della pagina predefinite sono 10.

Parametri

Invio

EmbeddedTableChartBuilder: questo builder è utile per l'accodamento.

Attiva la paginazione e imposta il numero di righe in ogni pagina.

Le dimensioni della pagina predefinite sono 10.

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

Parametri

Invio

EmbeddedTableChartBuilder: questo builder è utile per l'accodamento.

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

Le dimensioni pagina predefinite sono 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

Invio

EmbeddedTableChartBuilder: questo builder è utile per l'accodamento.

Aggiunge il supporto di base per le lingue da destra a sinistra (ad esempio 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 di colonna nei dati sottostanti, ma solo sull'ordine di visualizzazione. La visualizzazione completa delle lingue bidirezionali (BiDi) 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 richieste della tabella. Il comportamento predefinito è il supporto RTL disattivato.

Parametri

Invio

EmbeddedTableChartBuilder: questo builder è utile per l'accodamento.

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

Invio

EmbeddedTableChartBuilder: questo builder è utile per l'accodamento.

Restituisce il tipo di grafico corrente.

Invio

ChartType: il tipo di grafico

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

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

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

Invio

EmbeddedChartBuilder: questo generatore, per l'accodamento

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

Invio

EmbeddedChartBuilder: questo generatore, per l'accodamento

Imposta il numero della prima riga della tabella di 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

Invio

EmbeddedTableChartBuilder: questo builder è utile per l'accodamento.

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

Invio

EmbeddedChartBuilder: questo generatore, per l'accodamento

Imposta l'indice della colonna in base alla quale la tabella deve essere inizialmente ordinata (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

Invio

EmbeddedTableChartBuilder: questo builder è utile per l'accodamento.

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

Invio

EmbeddedTableChartBuilder: questo builder è utile per l'accodamento.

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

Invio

EmbeddedChartBuilder: questo generatore, per l'accodamento

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

Invio

EmbeddedChartBuilder: questo generatore, per l'accodamento

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

Invio

EmbeddedChartBuilder: questo generatore, per l'accodamento.

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

Invio

EmbeddedChartBuilder: questo generatore, per l'accodamento

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

Invio

EmbeddedChartBuilder: questo generatore, per l'accodamento

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

Il comportamento predefinito non mostra i numeri di riga.

Parametri

Invio

EmbeddedTableChartBuilder: questo builder è utile per l'accodamento.

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

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

Parametri

Invio

EmbeddedTableChartBuilder: questo builder è utile per l'accodamento.