Esta página foi traduzida pela API Cloud Translation.

Class ColumnChartBuilder

Criador para gráficos de colunas. Para mais detalhes, consulte a documentação do Google Charts.

Este exemplo mostra como criar um gráfico de colunas com dados de uma tabela de dados.

var sampleData = Charts.newDataTable()
    .addColumn(Charts.ColumnType.STRING, "Year")
    .addColumn(Charts.ColumnType.NUMBER, "Sales")
    .addColumn(Charts.ColumnType.NUMBER, "Expenses")
    .addRow(["2004", 1000, 400])
    .addRow(["2005", 1170, 460])
    .addRow(["2006", 660, 1120])
    .addRow(["2007", 1030, 540])
    .addRow(["2008", 800, 600])
    .addRow(["2009", 943, 678])
    .addRow(["2010", 1020, 550])
    .addRow(["2011", 910, 700])
    .addRow(["2012", 1230, 840])
    .build();

var chart = Charts.newColumnChart()
    .setTitle('Sales & Expenses')
    .setXAxisTitle('Year')
    .setYAxisTitle('Amount (USD)')
    .setDimensions(600, 500)
    .setDataTable(sampleData)
    .build();

Métodos

Método	Tipo de retorno	Breve descrição
`build()`	`Chart`	Cria o gráfico.
`reverseCategories()`	`ColumnChartBuilder`	Reverte o desenho de séries no eixo do domínio.
`setBackgroundColor(cssValue)`	`ColumnChartBuilder`	Define a cor do plano de fundo do gráfico.
`setColors(cssValues)`	`ColumnChartBuilder`	Define as cores das linhas no gráfico.
`setDataSourceUrl(url)`	`ColumnChartBuilder`	Define o URL da fonte de dados usado para extrair dados de uma fonte externa, como o Google. Planilhas.
`setDataTable(tableBuilder)`	`ColumnChartBuilder`	Define a tabela de dados a ser usada no gráfico usando um DataTableBuilder.
`setDataTable(table)`	`ColumnChartBuilder`	Define a tabela de dados que contém as linhas do gráfico, bem como os rótulos do eixo X.
`setDataViewDefinition(dataViewDefinition)`	`ColumnChartBuilder`	Define a definição da visualização de dados a ser usada no gráfico.
`setDimensions(width, height)`	`ColumnChartBuilder`	Define as dimensões do gráfico.
`setLegendPosition(position)`	`ColumnChartBuilder`	Define a posição da legenda em relação ao gráfico.
`setLegendTextStyle(textStyle)`	`ColumnChartBuilder`	Define o estilo do texto da legenda do gráfico.
`setOption(option, value)`	`ColumnChartBuilder`	Define opções avançadas para este gráfico.
`setRange(start, end)`	`ColumnChartBuilder`	Define o intervalo do gráfico.
`setStacked()`	`ColumnChartBuilder`	Usa linhas empilhadas, o que significa que os valores de linha e barra são empilhados (acumulados).
`setTitle(chartTitle)`	`ColumnChartBuilder`	Define o título do gráfico.
`setTitleTextStyle(textStyle)`	`ColumnChartBuilder`	Define o estilo de texto do título do gráfico.
`setXAxisTextStyle(textStyle)`	`ColumnChartBuilder`	Define o estilo do texto do eixo horizontal.
`setXAxisTitle(title)`	`ColumnChartBuilder`	Adiciona um título ao eixo horizontal.
`setXAxisTitleTextStyle(textStyle)`	`ColumnChartBuilder`	Define o estilo do texto do título do eixo horizontal.
`setYAxisTextStyle(textStyle)`	`ColumnChartBuilder`	Define o estilo do texto do eixo vertical.
`setYAxisTitle(title)`	`ColumnChartBuilder`	Adiciona um título ao eixo vertical.
`setYAxisTitleTextStyle(textStyle)`	`ColumnChartBuilder`	Define o estilo do texto do título do eixo vertical.
`useLogScale()`	`ColumnChartBuilder`	Transforma o eixo do intervalo em uma escala logarítmica (requer que todos os valores sejam positivos).

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.

`reverseCategories()`

Reverte o desenho de séries no eixo do domínio. Para gráficos de intervalo vertical (como linhas, gráficos de área ou colunas), o eixo horizontal é desenhado da direita para a esquerda. Para gráficos de intervalo horizontal (como os gráficos de barras), significa que o eixo vertical é desenhado do topo para fundo. Para gráficos de pizza, isso significa que as fatias são desenhadas no sentido anti-horário.

// Creates a pie chart builder and sets drawing of the slices in a counter-clockwise manner.
var builder = Charts.newPieChart();
builder.reverseCategories();

Retornar

ColumnChartBuilder: esse builder, útil para encadeamentos.

`setBackgroundColor(cssValue)`

Define a cor do plano de fundo do gráfico.

// Creates a line chart builder and sets the background color to gray
var builder = Charts.newLineChart();
builder.setBackgroundColor("gray");

Parâmetros

Nome	Tipo	Descrição
`cssValue`	`String`	O valor de CSS para a cor (como `"blue"` ou `"#00f"`).

Retornar

ColumnChartBuilder: esse builder, útil para encadeamentos.

`setColors(cssValues)`

Define as cores das linhas no gráfico.

// Creates a line chart builder and sets the first two lines to be drawn in green and red,
// respectively.
var builder = Charts.newLineChart();
builder.setColors(["green", "red"]);

Parâmetros

Nome	Tipo	Descrição
`cssValues`	`String[]`	Uma matriz de valores CSS de cor, como `["red", "#acf"]`. O enésimo elemento na matriz representa a cor da enésima linha no gráfico.

Retornar

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

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

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

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

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

ColumnChartBuilder: esse builder, útil para encadeamentos.

`setLegendPosition(position)`

Define a posição da legenda em relação ao gráfico. Por padrão, não há legendas.

// Creates a line chart builder and sets the legend position to right.
var builder = Charts.newLineChart();
builder.setLegendPosition(Charts.Position.RIGHT);

Parâmetros

Nome	Tipo	Descrição
`position`	`Position`	A posição da legenda.

Retornar

ColumnChartBuilder: esse builder, útil para encadeamentos.

`setLegendTextStyle(textStyle)`

Define o estilo do texto da legenda do gráfico.

// Creates a line chart builder and sets it up for a  blue, 26-point legend.
var textStyleBuilder = Charts.newTextStyle().setColor('#0000FF').setFontSize(26);
var style = textStyleBuilder.build();
var builder = Charts.newLineChart();
builder.setLegendTextStyle(style);

Parâmetros

Nome	Tipo	Descrição
`textStyle`	`TextStyle`	O estilo de texto a ser usado para a legenda do gráfico.

Retornar

ColumnChartBuilder: 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 column chart with a 1-second animation duration.
var builder = Charts.newColumnChart();
builder.setOption('animation.duration', 1000);
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

ColumnChartBuilder: esse builder, útil para encadeamentos.

`setRange(start, end)`

Define o intervalo do gráfico.

Se algum ponto de dados estiver fora do intervalo, o intervalo será expandido para incluir esses dados. pontos.

Parâmetros

Nome	Tipo	Descrição
`start`	`Number`	O valor da linha de grade mais baixa do eixo do intervalo.
`end`	`Number`	O valor da linha de grade mais alta do eixo do intervalo.

Retornar

ColumnChartBuilder: esse builder, útil para encadeamentos.

`setStacked()`

Usa linhas empilhadas, o que significa que os valores de linha e barra são empilhados (acumulados). Por padrão, não há empilhamento.

Retornar

ColumnChartBuilder: esse builder, útil para encadeamentos.

`setTitle(chartTitle)`

Define o título do gráfico. O título é exibido centralizado acima do gráfico.

// Creates a line chart builder and title to 'My Line Chart'.
var builder = Charts.newLineChart();
builder.setTitle('My Line Chart')

Parâmetros

Nome	Tipo	Descrição
`chartTitle`	`String`	o título do gráfico.

Retornar

ColumnChartBuilder: esse builder, útil para encadeamentos.

`setTitleTextStyle(textStyle)`

Define o estilo de texto do título do gráfico.

// Creates a line chart builder and sets it up for a  blue, 26-point title.
var textStyleBuilder = Charts.newTextStyle().setColor('#0000FF').setFontSize(26);
var style = textStyleBuilder.build();
var builder = Charts.newLineChart();
builder.setTitleTextStyle(style);

Parâmetros

Nome	Tipo	Descrição
`textStyle`	`TextStyle`	O estilo de texto a ser usado no título do gráfico. É possível criar um objeto `TextStyleBuilder` chamando `Charts.newTextStyle()`.

Retornar

ColumnChartBuilder: esse builder, útil para encadeamentos.

`setXAxisTextStyle(textStyle)`

Define o estilo do texto do eixo horizontal.

// Creates a line chart builder and sets the X-axis text style to blue, 18-point font.
var textStyle = Charts.newTextStyle().setColor('blue').setFontSize(18).build();
var builder = Charts.newLineChart();
builder.setXAxisTextStyle(textStyle);

Parâmetros

Nome	Tipo	Descrição
`textStyle`	`TextStyle`	O estilo de texto a ser usado no título do eixo horizontal. É possível criar um objeto `TextStyleBuilder` chamando `Charts.newTextStyle()`.

Retornar

ColumnChartBuilder: esse builder, útil para encadeamentos.

`setXAxisTitle(title)`

Adiciona um título ao eixo horizontal. O título é centralizado e aparece abaixo do valor do eixo rótulos.

// Creates a line chart builder and sets the X-axis title.
var builder = Charts.newLineChart();
builder.setTitle('X-axis Title')

Parâmetros

Nome	Tipo	Descrição
`title`	`String`	O título do eixo X.

Retornar

ColumnChartBuilder: esse builder, útil para encadeamentos.

`setXAxisTitleTextStyle(textStyle)`

Define o estilo do texto do título do eixo horizontal.

// Creates a line chart builder and sets the X-axis title text style to blue, 18-point font.
var textStyle = Charts.newTextStyle().setColor('blue').setFontSize(18).build();
var builder = Charts.newLineChart();
builder.setXAxisTitleTextStyle(textStyle);

Parâmetros

Nome	Tipo	Descrição
`textStyle`	`TextStyle`	O estilo de texto a ser usado no título do eixo horizontal. É possível criar um objeto `TextStyleBuilder` chamando `Charts.newTextStyle()`.

Retornar

ColumnChartBuilder: esse builder, útil para encadeamentos.

`setYAxisTextStyle(textStyle)`

Define o estilo do texto do eixo vertical.

// Creates a line chart builder and sets the Y-axis text style to blue, 18-point font.
var textStyle = Charts.newTextStyle().setColor('blue').setFontSize(18).build();
var builder = Charts.newLineChart();
builder.setYAxisTextStyle(textStyle);

Parâmetros

Nome	Tipo	Descrição
`textStyle`	`TextStyle`	O estilo de texto a ser usado no título do eixo horizontal. É possível criar um objeto `TextStyleBuilder` chamando `Charts.newTextStyle()`.

Retornar

ColumnChartBuilder: esse builder, útil para encadeamentos.

`setYAxisTitle(title)`

Adiciona um título ao eixo vertical. O título é centralizado e aparece à esquerda do valor. rótulos.

// Creates a line chart builder and sets the Y-axis title.
var builder = Charts.newLineChart();
builder.setYAxisTitle('Y-axis Title')

Parâmetros

Nome	Tipo	Descrição
`title`	`String`	Título do eixo Y.

Retornar

ColumnChartBuilder: esse builder, útil para encadeamentos.

`setYAxisTitleTextStyle(textStyle)`

Define o estilo do texto do título do eixo vertical.

// Creates a line chart builder and sets the Y-axis title text style to blue, 18-point font.
var textStyle = Charts.newTextStyle().setColor('blue').setFontSize(18).build();
var builder = Charts.newLineChart();
builder.setYAxisTitleTextStyle(textStyle);

Parâmetros

Nome	Tipo	Descrição
`textStyle`	`TextStyle`	O estilo de texto a ser usado no título do eixo horizontal. É possível criar um objeto `TextStyleBuilder` chamando `Charts.newTextStyle()`.

Retornar

ColumnChartBuilder: esse builder, útil para encadeamentos.

`useLogScale()`

Transforma o eixo do intervalo em uma escala logarítmica (requer que todos os valores sejam positivos). O intervalo são os eixos verticais para gráficos verticais (como linhas, áreas ou colunas) e o eixo eixo horizontal para gráficos horizontais (como de barras).

Retornar

ColumnChartBuilder: esse builder, útil para encadeamentos.