Class EmbeddedTableChartBuilder

Aggiunge un intervallo al grafico modificato da questo generatore. Non aggiunge l'intervallo se è già stato aggiunte 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

Invio

EmbeddedChartBuilder: questo builder, per il concatenamento

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 Grafico a barre 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 grafici a colonne

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

Invio

EmbeddedComboChartBuilder: uno strumento di creazione per un grafico combinato

Imposta il tipo di grafico su IstogramChart 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: uno strumento per la creazione di un grafico a linee

Imposta il tipo di grafico su Grafico a torta e restituisce un EmbeddedPieChartBuilder.

Invio

EmbeddedPieChartBuilder: uno strumento per la creazione di grafici a torta

Imposta il tipo di grafico su Grafico a dispersione 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

Crea il grafico per riflettere tutte le modifiche apportate.

Questo metodo non disegna automaticamente il grafico nella parte superiore del foglio di lavoro. Un nuovo grafico deve essere inserito tramite sheet.insertChart(chart) e un grafico esistente deve essere aggiornato 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);

Invio

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

Rimuove tutti gli intervalli dal grafico modificato da questo builder.

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

Invio

EmbeddedChartBuilder: questo builder, per il concatenamento

Consente di impostare se attivare il paging dei dati.

Il comportamento predefinito è il paging disabilitato. Se il paging è abilitato, la dimensione predefinita della pagina è 10.

Parametri

Invio

EmbeddedTableChartBuilder: questo builder, utile per il concatenamento.

Abilita il paging 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.
var builder = Charts.newTableChart();
builder.enablePaging(5);

Parametri

Invio

EmbeddedTableChartBuilder: questo builder, utile per il concatenamento.

Abilita il paging, imposta il numero di righe in ogni pagina e la prima pagina della tabella da visualizzare (pagina numeri sono su base zero).

La dimensione predefinita della pagina è 10, mentre la pagina iniziale predefinita è 0.

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

Parametri

Invio

EmbeddedTableChartBuilder: questo builder, utile per il concatenamento.

Aggiunge il supporto di base per le lingue da destra a sinistra (come l'arabo o l'ebraico) invertendo il nell'ordine delle colonne della tabella, in modo che la colonna zero sia la colonna più a destra e l'ultima sia la nella colonna più a sinistra.

Ciò non influisce sull'indice delle colonne nei dati sottostanti, ma solo sull'ordine di visualizzazione. La visualizzazione completa del linguaggio bidirezionale (BiDi) non è supportata dalla visualizzazione tabella, nemmeno con questa opzione. Questa opzione viene ignorata se attivi il paging (utilizzando l'opzione della pagina) o se la tabella contiene barre di scorrimento perché hai specificato opzioni di altezza e larghezza inferiori al la dimensione della tabella richiesta. Il comportamento predefinito è il supporto RTL disattivato.

Parametri

Invio

EmbeddedTableChartBuilder: questo builder, utile per il concatenamento.

Consente di impostare se ordinare le colonne quando l'utente fa clic su un'intestazione di colonna.

Se l'ordinamento è abilitato, quando gli utenti fanno clic sull'intestazione della colonna, le righe vengono automaticamente ordinato. Il comportamento predefinito è l'ordinamento abilitato.

Parametri

Invio

EmbeddedTableChartBuilder: questo builder, utile per il concatenamento.

Restituisce il tipo di grafico corrente.

Invio

ChartType: il tipo di grafico

Restituisce il grafico ContainerInfo, che racchiude il punto in cui appare il grafico in un foglio di calcolo.

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

Invio

ContainerInfo: un oggetto contenente la posizione del contenitore del grafico

Restituisce una copia dell'elenco di intervalli che attualmente forniscono dati per il grafico. Usa 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());
}

Invio

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

Rimuove l'intervallo specificato dal grafico modificato da questo builder. Non restituisce un errore se l'intervallo non è presente in questo grafico.

L'intervallo rimosso deve corrispondere a un intervallo aggiunto tramite addRange(range). altrimenti non vengono apportate modifiche al grafico. Impossibile utilizzare questo metodo 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

Invio

EmbeddedChartBuilder: questo builder, per il concatenamento

Modifica il tipo di grafico. Non tutti i tipi di grafici incorporati sono attualmente supportati. 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

Invio

EmbeddedChartBuilder: questo builder, per il concatenamento

Imposta il numero di riga per la prima riga della tabella di dati.

Il numero predefinito della prima riga è 1.

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

Parametri

Invio

EmbeddedTableChartBuilder: questo builder, utile per il concatenamento.

Consente di impostare la strategia da utilizzare per le righe e le 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

Invio

EmbeddedChartBuilder: questo builder, per il concatenamento

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

Il sistema operativo delle colonne è ordinato in ordine crescente ed è contrassegnato da una piccola freccia che lo indica.

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

Parametri

Invio

EmbeddedTableChartBuilder: questo builder, utile per il concatenamento.

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

Il sistema operativo della colonna è ordinato in ordine decrescente ed è contrassegnato da una piccola freccia che lo indica.

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

Parametri

Invio

EmbeddedTableChartBuilder: questo builder, utile per il concatenamento.

Imposta la strategia di unione da utilizzare quando è presente più di un intervallo. Se MERGE_ROWS, le righe vengono unite; Se 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

Invio

EmbeddedChartBuilder: questo builder, per il concatenamento

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

Invio

EmbeddedChartBuilder: questo builder, per il concatenamento

Imposta le opzioni avanzate per questo grafico. Per visualizzare un elenco delle opzioni disponibili, consulta la sezione Grafico opzioni di configurazione.

Questo metodo non convalida l'opzione specificata sia valida per questo tipo di grafico né se l'elemento siano nel formato/struttura corretto.

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

Invio

EmbeddedChartBuilder: questo builder, per il concatenamento.

Imposta la posizione, modificando la posizione del grafico nel foglio. anchorRowPos e anchorColPos sono indicizzati con 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

Invio

EmbeddedChartBuilder: questo builder, per il concatenamento

Imposta la trasposizione di righe e colonne del grafico. Se impostato su true, le righe e le vengono scambiate tra colonne. 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

Invio

EmbeddedChartBuilder: questo builder, per il concatenamento

Consente di impostare 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 il concatenamento.

Consente di impostare l'assegnazione dello stile di colore alternato alle righe pari e dispari di un grafico a tabella.

Il comportamento predefinito è costituito dalle righe con uno stile di colore alternato.

Parametri

Invio

EmbeddedTableChartBuilder: questo builder, utile per il concatenamento.