Questa pagina è stata tradotta dall'API Cloud Translation.

Class EmbeddedTableChartBuilder

Strumento per la creazione di grafici a tabella. Per ulteriori informazioni, consulta la documentazione di Gviz.

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 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 un `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 un `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 `EmbeddedScatterChartBuilder`.
`asTableChart()`	`EmbeddedTableChartBuilder`	Imposta il tipo di grafico su TableChart e restituisce un `EmbeddedTableChartBuilder`.
`build()`	`EmbeddedChart`	Crea il grafico per riflettere tutte le modifiche apportate.
`clearRanges()`	`EmbeddedChartBuilder`	Rimuove tutti gli intervalli dal grafico modificato da questo builder.
`enablePaging(enablePaging)`	`EmbeddedTableChartBuilder`	Consente di impostare se attivare il paging dei dati.
`enablePaging(pageSize)`	`EmbeddedTableChartBuilder`	Abilita il paging e imposta il numero di righe in ogni pagina.
`enablePaging(pageSize, startPage)`	`EmbeddedTableChartBuilder`	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).
`enableRtlTable(rtlEnabled)`	`EmbeddedTableChartBuilder`	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.
`enableSorting(enableSorting)`	`EmbeddedTableChartBuilder`	Consente di impostare se ordinare le colonne quando l'utente fa clic su un'intestazione di colonna.
`getChartType()`	`ChartType`	Restituisce il tipo di grafico corrente.
`getContainer()`	`ContainerInfo`	Restituisce il grafico `ContainerInfo`, che racchiude il punto in cui appare il grafico in un foglio di calcolo.
`getRanges()`	`Range[]`	Restituisce una copia dell'elenco di intervalli che attualmente forniscono dati per il grafico.
`removeRange(range)`	`EmbeddedChartBuilder`	Rimuove l'intervallo specificato dal grafico modificato da questo builder.
`setChartType(type)`	`EmbeddedChartBuilder`	Modifica il tipo di grafico.
`setFirstRowNumber(number)`	`EmbeddedTableChartBuilder`	Imposta il numero di riga per la prima riga della tabella di dati.
`setHiddenDimensionStrategy(strategy)`	`EmbeddedChartBuilder`	Consente di impostare la strategia da utilizzare per le righe e le colonne nascoste.
`setInitialSortingAscending(column)`	`EmbeddedTableChartBuilder`	Imposta l'indice della colonna in base al quale la tabella deve essere inizialmente ordinata (ordine crescente).
`setInitialSortingDescending(column)`	`EmbeddedTableChartBuilder`	Imposta l'indice della colonna in base al quale la tabella deve essere inizialmente ordinata (ordine decrescente).
`setMergeStrategy(mergeStrategy)`	`EmbeddedChartBuilder`	Imposta la strategia di unione da utilizzare quando è presente 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 la posizione del grafico nel foglio.
`setTransposeRowsAndColumns(transpose)`	`EmbeddedChartBuilder`	Imposta la trasposizione di righe e colonne del grafico.
`showRowNumberColumn(showRowNumber)`	`EmbeddedTableChartBuilder`	Consente di impostare se mostrare il numero di riga come prima colonna della tabella.
`useAlternatingRowStyle(alternate)`	`EmbeddedTableChartBuilder`	Consente di impostare l'assegnazione dello stile di colore alternato alle righe pari e dispari di un grafico a tabella.

Documentazione dettagliata

`addRange(range)`

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

Nome	Tipo	Descrizione
`range`	`Range`	L'intervallo da aggiungere.

Invio

EmbeddedChartBuilder: questo builder, per il concatenamento

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

`asComboChart()`

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

Invio

EmbeddedComboChartBuilder: uno strumento di creazione per un grafico combinato

`asHistogramChart()`

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

`asPieChart()`

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

Invio

EmbeddedPieChartBuilder: uno strumento per la creazione di grafici a torta

`asScatterChart()`

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

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

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

`clearRanges()`

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

`enablePaging(enablePaging)`

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

Nome	Tipo	Descrizione
`enablePaging`	`Boolean`	`true` se il paging deve essere abilitato, `false` altrimenti.

Invio

EmbeddedTableChartBuilder: questo builder, utile per il concatenamento.

`enablePaging(pageSize)`

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

Nome	Tipo	Descrizione
`pageSize`	`Integer`	Il numero di righe in ogni pagina della tabella.

Invio

EmbeddedTableChartBuilder: questo builder, utile per il concatenamento.

`enablePaging(pageSize, startPage)`

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

Nome	Tipo	Descrizione
`pageSize`	`Integer`	Il numero di righe in ogni pagina della tabella.
`startPage`	`Integer`	La prima pagina di tabella da visualizzare (i numeri di pagina sono in base zero).

Invio

EmbeddedTableChartBuilder: questo builder, utile per il concatenamento.

`enableRtlTable(rtlEnabled)`

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

Nome	Tipo	Descrizione
`rtlEnabled`	`Boolean`	`true` se il supporto della scrittura da destra a sinistra deve essere attivato, `false` negli altri casi.

Invio

EmbeddedTableChartBuilder: questo builder, utile per il concatenamento.

`enableSorting(enableSorting)`

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

Nome	Tipo	Descrizione
`enableSorting`	`Boolean`	`true` per abilitare l'ordinamento facendo clic sulle intestazioni di colonna, altrimenti `false`.

Invio

EmbeddedTableChartBuilder: questo builder, utile per il concatenamento.

`getChartType()`

Restituisce il tipo di grafico corrente.

Invio

ChartType: il tipo di grafico

`getContainer()`

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

`getRanges()`

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

`removeRange(range)`

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

Nome	Tipo	Descrizione
`range`	`Range`	L'intervallo da rimuovere.

Invio

EmbeddedChartBuilder: questo builder, per il concatenamento

`setChartType(type)`

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

Nome	Tipo	Descrizione
`type`	`ChartType`	Il tipo in cui modificare il grafico.

Invio

EmbeddedChartBuilder: questo builder, per il concatenamento

`setFirstRowNumber(number)`

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

Nome	Tipo	Descrizione
`number`	`Integer`	Il numero di riga per la prima riga nella tabella di dati.

Invio

EmbeddedTableChartBuilder: questo builder, utile per il concatenamento.

`setHiddenDimensionStrategy(strategy)`

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

Nome	Tipo	Descrizione
`strategy`	`ChartHiddenDimensionStrategy`	La strategia da utilizzare per le righe e le colonne nascoste.

Invio

EmbeddedChartBuilder: questo builder, per il concatenamento

`setInitialSortingAscending(column)`

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

Nome	Tipo	Descrizione
`column`	`Integer`	Il numero della colonna in base al quale deve essere inizialmente ordinata la tabella.

Invio

EmbeddedTableChartBuilder: questo builder, utile per il concatenamento.

`setInitialSortingDescending(column)`

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

Nome	Tipo	Descrizione
`column`	`Integer`	Il numero della colonna in base al quale deve essere inizialmente ordinata la tabella.

Invio

EmbeddedTableChartBuilder: questo builder, utile per il concatenamento.

`setMergeStrategy(mergeStrategy)`

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

Nome	Tipo	Descrizione
`mergeStrategy`	`ChartMergeStrategy`	La strategia di unione da utilizzare.

Invio

EmbeddedChartBuilder: questo builder, 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 trattare come intestazioni. I valori negativi causano le intestazioni il rilevamento automatico.

Invio

EmbeddedChartBuilder: questo builder, per il concatenamento

`setOption(option, value)`

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

Nome	Tipo	Descrizione
`option`	`String`	Il nome dell'opzione.
`value`	`Object`	Il valore dell'opzione.

Invio

EmbeddedChartBuilder: questo builder, per il concatenamento.

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

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

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 superiore destro del grafico è spostato di questo numero di pixel.
`offsetY`	`Integer`	L'angolo inferiore sinistro del grafico è spostato di questo numero di pixel.

Invio

EmbeddedChartBuilder: questo builder, per il concatenamento

`setTransposeRowsAndColumns(transpose)`

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

Nome	Tipo	Descrizione
`transpose`	`Boolean`	Se `true`, le righe e le colonne utilizzate per creare il grafico sono trasposta.

Invio

EmbeddedChartBuilder: questo builder, per il concatenamento

`showRowNumberColumn(showRowNumber)`

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

Il comportamento predefinito non mostra i numeri di riga.

Parametri

Nome	Tipo	Descrizione
`showRowNumber`	`Boolean`	`true` se la prima colonna della tabella deve mostrare il numero di riga, `false` negli altri casi.

Invio

EmbeddedTableChartBuilder: questo builder, utile per il concatenamento.

`useAlternatingRowStyle(alternate)`

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

Nome	Tipo	Descrizione
`alternate`	`Boolean`	`true` se gli stili di colore devono essere alternati, `false` altrimenti.

Invio

EmbeddedTableChartBuilder: questo builder, utile per il concatenamento.