Class TableChartBuilder

TableChartBuilder

Uno strumento per la creazione di grafici a tabella. Per ulteriori informazioni, consulta la documentazione di Google Chart.

Ecco un esempio che mostra come creare un grafico a tabella. I dati vengono importati da un foglio di lavoro Google. 

// Get sample data from a spreadsheet.
var dataSourceUrl = 'https://docs.google.com/spreadsheet/tq?range=A1%3AF' +
    '&key=0Aq4s9w_HxMs7dHpfX05JdmVSb1FpT21sbXd4NVE3UEE&gid=4&headers=-1';

var chartBuilder = Charts.newTableChart()
    .setDimensions(600, 500)
    .enablePaging(20)
    .setDataSourceUrl(dataSourceUrl);

var chart = chartBuilder.build();

Metodi

MetodoTipo restituitoBreve descrizione
build()ChartCrea il grafico.
enablePaging(enablePaging)TableChartBuilderConsente di impostare se attivare il paging tra i dati.
enablePaging(pageSize)TableChartBuilderAbilita il paging e imposta il numero di righe in ogni pagina.
enablePaging(pageSize, startPage)TableChartBuilderAbilita il paging, imposta il numero di righe in ogni pagina e la prima pagina della tabella da visualizzare (i numeri di pagina sono in base zero).
enableRtlTable(rtlEnabled)TableChartBuilderAggiunge il supporto di base per le lingue con orientamento da destra a sinistra (come l'arabo o l'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 quella più a sinistra.
enableSorting(enableSorting)TableChartBuilderConsente di scegliere se ordinare le colonne quando l'utente fa clic su un'intestazione di colonna.
setDataSourceUrl(url)TableChartBuilderImposta l'URL dell'origine dati utilizzato per estrarre i dati da un'origine esterna, ad esempio Fogli Google.
setDataTable(tableBuilder)TableChartBuilderImposta la tabella di dati da utilizzare per il grafico utilizzando un DataTableBuilder.
setDataTable(table)TableChartBuilderImposta la tabella di dati che contiene le linee per il grafico e le etichette dell'asse X.
setDataViewDefinition(dataViewDefinition)TableChartBuilderImposta la definizione della vista dati da utilizzare per il grafico.
setDimensions(width, height)TableChartBuilderImposta le dimensioni del grafico.
setFirstRowNumber(number)TableChartBuilderImposta il numero di riga per la prima riga nella tabella di dati.
setInitialSortingAscending(column)TableChartBuilderImposta l'indice della colonna in base al quale la tabella dovrebbe essere ordinata inizialmente (ordine crescente).
setInitialSortingDescending(column)TableChartBuilderImposta l'indice della colonna in base al quale la tabella deve essere ordinata inizialmente (decrescente).
setOption(option, value)TableChartBuilderImposta le opzioni avanzate per questo grafico.
showRowNumberColumn(showRowNumber)TableChartBuilderConsente di impostare se mostrare il numero di riga come prima colonna della tabella.
useAlternatingRowStyle(alternate)TableChartBuilderConsente di impostare se lo stile di colore alternato viene assegnato alle righe pari e dispari di un grafico tabella.

Documentazione dettagliata

build()

Crea il grafico.

Ritorni

Chart: oggetto Chart che può essere incorporato in documenti ed elementi dell'interfaccia utente o utilizzato come immagine statica.

enablePaging(enablePaging)

Consente di impostare se attivare il paging tra i dati.

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

Parametri

NomeTipoDescrizione
enablePagingBooleantrue se deve essere attivato il paging, false in caso contrario.

Ritorni

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

NomeTipoDescrizione
pageSizeIntegerIl numero di righe in ogni pagina della tabella.

Ritorni

TableChartBuilder: 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 (i numeri di pagina sono in base zero).

La dimensione predefinita della pagina è 10, mentre la pagina iniziale è 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

NomeTipoDescrizione
pageSizeIntegerIl numero di righe in ogni pagina della tabella.
startPageIntegerLa prima pagina della tabella da visualizzare (i numeri di pagina sono in base zero).

Ritorni

TableChartBuilder: questo builder, utile per il concatenamento.

enableRtlTable(rtlEnabled)

Aggiunge il supporto di base per le lingue con orientamento da destra a sinistra (come l'arabo o l'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 quella più a sinistra.

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

Parametri

NomeTipoDescrizione
rtlEnabledBooleantrue se è necessario attivare il supporto da destra a sinistra, false in caso contrario.

Ritorni

TableChartBuilder: questo builder, utile per il concatenamento.

enableSorting(enableSorting)

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

Parametri

NomeTipoDescrizione
enableSortingBooleantrue per attivare l'ordinamento facendo clic sulle intestazioni di colonna, altrimenti false.

Ritorni

TableChartBuilder: questo builder, utile per il concatenamento.

setDataSourceUrl(url)

Imposta l'URL dell'origine dati utilizzato per estrarre i dati da un'origine esterna, ad esempio Fogli Google. Se vengono forniti un URL di origine dati e una DataTable, l'URL dell'origine dati viene ignorato.

Per ulteriori informazioni sull'esecuzione di query sulle origini dati, consulta la documentazione di Grafici Google.

Parametri

NomeTipoDescrizione
urlStringL'URL dell'origine dati, inclusi eventuali parametri di ricerca.

Ritorni

TableChartBuilder: questo builder, utile per il concatenamento.

setDataTable(tableBuilder)

Imposta la tabella di dati da utilizzare per il grafico utilizzando un DataTableBuilder. Questo è un metodo pratico per impostare la tabella di dati senza dover chiamare build().

Parametri

NomeTipoDescrizione
tableBuilderDataTableBuilderUn generatore di tabelle di dati. Nell'ambito di questa chiamata viene creata immediatamente una nuova tabella di dati, pertanto eventuali ulteriori aggiornamenti al builder non saranno visualizzati nel grafico.

Ritorni

TableChartBuilder: questo builder, utile per il concatenamento.

setDataTable(table)

Imposta la tabella di dati che contiene le linee per il grafico e le etichette dell'asse X. La prima colonna deve essere una stringa e contenere le etichette dell'asse orizzontale. Può seguire un numero qualsiasi di colonne, tutte devono essere numeriche. Ogni colonna viene visualizzata come una riga separata.

Parametri

NomeTipoDescrizione
tableDataTableSourceLa tabella di dati da utilizzare per il grafico.

Ritorni

TableChartBuilder: questo builder, utile per il concatenamento.

setDataViewDefinition(dataViewDefinition)

Imposta la definizione della vista dati da utilizzare per il grafico.

Parametri

NomeTipoDescrizione
dataViewDefinitionDataViewDefinitionUn oggetto di definizione delle viste dati che definisce la vista da derivare dall'origine dati specificata per il disegno del grafico.

Ritorni

TableChartBuilder: questo builder, utile per il concatenamento.

setDimensions(width, height)

Imposta le dimensioni del grafico.

Parametri

NomeTipoDescrizione
widthIntegerLa larghezza del grafico in pixel.
heightIntegerL'altezza del grafico in pixel.

Ritorni

TableChartBuilder: questo builder, utile per il concatenamento.

setFirstRowNumber(number)

Imposta il numero di riga per la prima riga nella 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

NomeTipoDescrizione
numberIntegerIl numero di riga per la prima riga nella tabella di dati.

Ritorni

TableChartBuilder: questo builder, utile per il concatenamento.

setInitialSortingAscending(column)

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

Il sistema operativo della colonna è 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

NomeTipoDescrizione
columnIntegerIl numero della colonna in base alla quale deve essere ordinata inizialmente la tabella.

Ritorni

TableChartBuilder: questo builder, utile per il concatenamento.

setInitialSortingDescending(column)

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

NomeTipoDescrizione
columnIntegerIl numero della colonna in base alla quale deve essere ordinata inizialmente la tabella.

Ritorni

TableChartBuilder: questo builder, utile per il concatenamento.

setOption(option, value)

Imposta le opzioni avanzate per questo grafico. Consulta le opzioni disponibili per questo grafico. Questo metodo non ha effetto se l'opzione specificata non è valida. 

// Build a table chart which renders HTML.
var builder = Charts.newTableChart();
builder.setOption('allowHtml', {@code true});
var chart = builder.build();

Parametri

NomeTipoDescrizione
optionStringL'opzione da impostare.
valueObjectIl valore da impostare.

Ritorni

TableChartBuilder: questo builder, utile 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

NomeTipoDescrizione
showRowNumberBooleantrue se la prima colonna della tabella deve mostrare il numero di riga, false in caso contrario.

Ritorni

TableChartBuilder: questo builder, utile per il concatenamento.

useAlternatingRowStyle(alternate)

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

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

Parametri

NomeTipoDescrizione
alternateBooleantrue se gli stili di colore devono alternare, false in caso contrario.

Ritorni

TableChartBuilder: questo builder, utile per il concatenamento.