Esta página foi traduzida pela API Cloud Translation.

Class TableChartBuilder

Um criador para gráficos de tabela. Para mais detalhes, consulte a documentação do Google Charts.

Aqui está um exemplo que mostra como criar um gráfico de tabela. Os dados são importados de uma planilha do 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();

Métodos

Método	Tipo de retorno	Breve descrição
`build()`	`Chart`	Cria o gráfico.
`enablePaging(enablePaging)`	`TableChartBuilder`	Define se a paginação pelos dados será ativada.
`enablePaging(pageSize)`	`TableChartBuilder`	Ativa a paginação e define o número de linhas em cada página.
`enablePaging(pageSize, startPage)`	`TableChartBuilder`	Ativa a paginação, define o número de linhas em cada página e a primeira página da tabela a ser exibida (página e números são baseados em zero).
`enableRtlTable(rtlEnabled)`	`TableChartBuilder`	Adiciona suporte básico a idiomas escritos da direita para a esquerda (como árabe ou hebraico) invertendo o a ordem das colunas da tabela, de modo que a coluna zero seja a coluna mais à direita e a última seja na coluna mais à esquerda.
`enableSorting(enableSorting)`	`TableChartBuilder`	Define se as colunas serão classificadas quando o usuário clicar no cabeçalho de uma coluna.
`setDataSourceUrl(url)`	`TableChartBuilder`	Define o URL da fonte de dados usado para extrair dados de uma fonte externa, como o Google. Planilhas.
`setDataTable(tableBuilder)`	`TableChartBuilder`	Define a tabela de dados a ser usada no gráfico usando um DataTableBuilder.
`setDataTable(table)`	`TableChartBuilder`	Define a tabela de dados que contém as linhas do gráfico, bem como os rótulos do eixo X.
`setDataViewDefinition(dataViewDefinition)`	`TableChartBuilder`	Define a definição da visualização de dados a ser usada no gráfico.
`setDimensions(width, height)`	`TableChartBuilder`	Define as dimensões do gráfico.
`setFirstRowNumber(number)`	`TableChartBuilder`	Define o número da primeira linha na tabela de dados.
`setInitialSortingAscending(column)`	`TableChartBuilder`	Define o índice da coluna de acordo com o qual a tabela será inicialmente classificada (crescente).
`setInitialSortingDescending(column)`	`TableChartBuilder`	Define o índice da coluna de acordo com o qual a tabela será inicialmente classificada (decrescente).
`setOption(option, value)`	`TableChartBuilder`	Define opções avançadas para este gráfico.
`showRowNumberColumn(showRowNumber)`	`TableChartBuilder`	Define se o número da linha será mostrado como a primeira coluna da tabela.
`useAlternatingRowStyle(alternate)`	`TableChartBuilder`	Define se o estilo de cores alternadas é atribuído a linhas pares e ímpares de um gráfico de tabela.

Documentação detalhada

`build()`

Cria o gráfico.

Retornar

Chart: um objeto de gráfico, que pode ser incorporado em documentos, elementos de IU ou usado como um imagem.

`enablePaging(enablePaging)`

Define se a paginação pelos dados será ativada.

O comportamento padrão é a paginação desativada. Se a paginação estiver ativada, o tamanho de página padrão será 10.

Parâmetros

Nome	Tipo	Descrição
`enablePaging`	`Boolean`	`true` se a paginação precisar ser ativada. Caso contrário, `false`.

Retornar

TableChartBuilder: esse builder, útil para encadeamentos.

`enablePaging(pageSize)`

Ativa a paginação e define o número de linhas em cada página.

O tamanho de página padrão é 10.

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

Parâmetros

Nome	Tipo	Descrição
`pageSize`	`Integer`	O número de linhas em cada página da tabela.

Retornar

TableChartBuilder: esse builder, útil para encadeamentos.

`enablePaging(pageSize, startPage)`

Ativa a paginação, define o número de linhas em cada página e a primeira página da tabela a ser exibida (página e números são baseados em zero).

O tamanho de página padrão é 10, e a página inicial padrão é 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);

Parâmetros

Nome	Tipo	Descrição
`pageSize`	`Integer`	O número de linhas em cada página da tabela.
`startPage`	`Integer`	A primeira página da tabela a ser exibida (os números das páginas são baseados em zero).

Retornar

TableChartBuilder: esse builder, útil para encadeamentos.

`enableRtlTable(rtlEnabled)`

Adiciona suporte básico a idiomas escritos da direita para a esquerda (como árabe ou hebraico) invertendo o a ordem das colunas da tabela, de modo que a coluna zero seja a coluna mais à direita e a última seja na coluna mais à esquerda.

Isso não afeta o índice da coluna nos dados subjacentes, apenas a ordem de exibição. A exibição de idiomas bidirecional (BiDi) total não é suportada pela visualização de tabela, mesmo com essa opção. Esta opção será ignorada se você ativar a paginação (usando a opção de página) ou se a tabela tem barras de rolagem porque você especificou opções de altura e largura menores que as tamanho de tabela necessário. O comportamento padrão é o suporte a RTL desativado.

Parâmetros

Nome	Tipo	Descrição
`rtlEnabled`	`Boolean`	`true` se o suporte à direita para a esquerda precisar ser ativado, `false` caso contrário.

Retornar

TableChartBuilder: esse builder, útil para encadeamentos.

`enableSorting(enableSorting)`

Define se as colunas serão classificadas quando o usuário clicar no cabeçalho de uma coluna.

Se a classificação estiver ativada, quando os usuários clicarem no cabeçalho da coluna, as linhas serão automaticamente classificados. O comportamento padrão é a classificação ativada.

Parâmetros

Nome	Tipo	Descrição
`enableSorting`	`Boolean`	`true` para ativar a classificação clicando nos cabeçalhos das colunas. Caso contrário, clique em `false`.

Retornar

TableChartBuilder: esse builder, útil para encadeamentos.

`setDataSourceUrl(url)`

Define o URL da fonte de dados usado para extrair dados de uma fonte externa, como o Google. Planilhas. Se um URL de fonte de dados e uma tabela de dados forem fornecidos, o URL da fonte será ignorado.

Para mais informações sobre como consultar fontes de dados, confira a documentação do Google Charts.

Parâmetros

Nome	Tipo	Descrição
`url`	`String`	O URL da fonte de dados, incluindo quaisquer parâmetros de consulta.

Retornar

TableChartBuilder: esse builder, útil para encadeamentos.

`setDataTable(tableBuilder)`

Define a tabela de dados a ser usada no gráfico usando um DataTableBuilder. Esse é um método de conveniência para definir a tabela de dados sem precisar chamar build().

Parâmetros

Nome	Tipo	Descrição
`tableBuilder`	`DataTableBuilder`	Um criador de tabela de dados. Uma nova tabela de dados é criada instantaneamente como parte para que outras atualizações do builder não sejam refletidas no gráfico.

Retornar

TableChartBuilder: esse builder, útil para encadeamentos.

`setDataTable(table)`

Define a tabela de dados que contém as linhas do gráfico, bem como os rótulos do eixo X. A deve ser uma string e conter os rótulos do eixo horizontal. Qualquer número de colunas que podem ser seguidas, todos devem ser numéricos. Cada coluna é exibida como uma linha separada.

Parâmetros

Nome	Tipo	Descrição
`table`	`DataTableSource`	A tabela de dados a ser usada no gráfico.

Retornar

TableChartBuilder: esse builder, útil para encadeamentos.

`setDataViewDefinition(dataViewDefinition)`

Define a definição da visualização de dados a ser usada no gráfico.

Parâmetros

Nome	Tipo	Descrição
`dataViewDefinition`	`DataViewDefinition`	Um objeto de definição de visualização de dados que define a visualização que deve ser da fonte de dados para o desenho do gráfico.

Retornar

TableChartBuilder: esse builder, útil para encadeamentos.

`setDimensions(width, height)`

Define as dimensões do gráfico.

Parâmetros

Nome	Tipo	Descrição
`width`	`Integer`	A largura do gráfico, em pixels.
`height`	`Integer`	A altura do gráfico, em pixels.

Retornar

TableChartBuilder: esse builder, útil para encadeamentos.

`setFirstRowNumber(number)`

Define o número da primeira linha na tabela de dados.

O número padrão da primeira linha é 1.

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

Parâmetros

Nome	Tipo	Descrição
`number`	`Integer`	O número da primeira linha na tabela de dados.

Retornar

TableChartBuilder: esse builder, útil para encadeamentos.

`setInitialSortingAscending(column)`

Define o índice da coluna de acordo com o qual a tabela será inicialmente classificada (crescente).

A coluna está classificada em ordem crescente e marcada com uma pequena seta indicando isso.

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

Parâmetros

Nome	Tipo	Descrição
`column`	`Integer`	O número da coluna de acordo com a qual a tabela será inicialmente classificada.

Retornar

TableChartBuilder: esse builder, útil para encadeamentos.

`setInitialSortingDescending(column)`

Define o índice da coluna de acordo com o qual a tabela será inicialmente classificada (decrescente).

A coluna é classificada em ordem decrescente e é marcada com uma pequena seta indicando isso.

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

Parâmetros

Nome	Tipo	Descrição
`column`	`Integer`	O número da coluna de acordo com a qual a tabela será inicialmente classificada.

Retornar

TableChartBuilder: esse builder, útil para encadeamentos.

`setOption(option, value)`

Define opções avançadas para este gráfico. Veja as opções disponíveis para este gráfico. Esse método não terá efeito se a opção fornecida for inválida.

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

Parâmetros

Nome	Tipo	Descrição
`option`	`String`	A opção a ser definida.
`value`	`Object`	O valor que será definido.

Retornar

TableChartBuilder: esse builder, útil para encadeamentos.

`showRowNumberColumn(showRowNumber)`

Define se o número da linha será mostrado como a primeira coluna da tabela.

O comportamento padrão é não mostrar números de linha.

Parâmetros

Nome	Tipo	Descrição
`showRowNumber`	`Boolean`	`true` se a primeira coluna da tabela precisar mostrar o número da linha; Caso contrário, `false`.

Retornar

TableChartBuilder: esse builder, útil para encadeamentos.

`useAlternatingRowStyle(alternate)`

Define se o estilo de cores alternadas é atribuído a linhas pares e ímpares de um gráfico de tabela.

O comportamento padrão são as linhas com estilo de cores alternadas.

Parâmetros

Nome	Tipo	Descrição
`alternate`	`Boolean`	`true` se os estilos de cor precisarem ser alternados. Caso contrário, `false`.

Retornar

TableChartBuilder: esse builder, útil para encadeamentos.