Class LineChartBuilder

LineChartBuilder

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

Aqui está um exemplo que mostra como criar um gráfico de linhas. 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%3AG5' +
      '&key=0Aq4s9w_HxMs7dHpfX05JdmVSb1FpT21sbXd4NVE3UEE&gid=2&headers=-1';

  var chartBuilder = Charts.newLineChart()
      .setTitle('Yearly Rainfall')
      .setXAxisTitle('Month')
      .setYAxisTitle('Rainfall (in)')
      .setDimensions(600, 500)
      .setCurveStyle(Charts.CurveStyle.SMOOTH)
      .setPointStyle(Charts.PointStyle.MEDIUM)
      .setDataSourceUrl(dataSourceUrl);

  var chart = chartBuilder.build();

Métodos

MétodoTipo de retornoBreve descrição
build()ChartCria o gráfico.
reverseCategories()LineChartBuilderReverte o desenho de séries no eixo do domínio.
setBackgroundColor(cssValue)LineChartBuilderDefine a cor do plano de fundo do gráfico.
setColors(cssValues)LineChartBuilderDefine as cores das linhas no gráfico.
setCurveStyle(style)LineChartBuilderDefine o estilo a ser usado para curvas no gráfico.
setDataSourceUrl(url)LineChartBuilderDefine o URL da fonte de dados usado para extrair dados de uma fonte externa, como o Google. Planilhas.
setDataTable(tableBuilder)LineChartBuilderDefine a tabela de dados a ser usada no gráfico usando um DataTableBuilder.
setDataTable(table)LineChartBuilderDefine a tabela de dados que contém as linhas do gráfico, bem como os rótulos do eixo X.
setDataViewDefinition(dataViewDefinition)LineChartBuilderDefine a definição da visualização de dados a ser usada no gráfico.
setDimensions(width, height)LineChartBuilderDefine as dimensões do gráfico.
setLegendPosition(position)LineChartBuilderDefine a posição da legenda em relação ao gráfico.
setLegendTextStyle(textStyle)LineChartBuilderDefine o estilo do texto da legenda do gráfico.
setOption(option, value)LineChartBuilderDefine opções avançadas para este gráfico.
setPointStyle(style)LineChartBuilderDefine o estilo dos pontos na linha.
setRange(start, end)LineChartBuilderDefine o intervalo do gráfico.
setTitle(chartTitle)LineChartBuilderDefine o título do gráfico.
setTitleTextStyle(textStyle)LineChartBuilderDefine o estilo de texto do título do gráfico.
setXAxisTextStyle(textStyle)LineChartBuilderDefine o estilo do texto do eixo horizontal.
setXAxisTitle(title)LineChartBuilderAdiciona um título ao eixo horizontal.
setXAxisTitleTextStyle(textStyle)LineChartBuilderDefine o estilo do texto do título do eixo horizontal.
setYAxisTextStyle(textStyle)LineChartBuilderDefine o estilo do texto do eixo vertical.
setYAxisTitle(title)LineChartBuilderAdiciona um título ao eixo vertical.
setYAxisTitleTextStyle(textStyle)LineChartBuilderDefine o estilo do texto do título do eixo vertical.
useLogScale()LineChartBuilderTransforma 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

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

NomeTipoDescrição
cssValueStringO valor de CSS para a cor (como "blue" ou "#00f").

Retornar

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

NomeTipoDescrição
cssValuesString[]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

LineChartBuilder: esse builder, útil para encadeamentos.


setCurveStyle(style)

Define o estilo a ser usado para curvas no gráfico. Confira a curva permitida em CurveStyle estilos.

// Creates a line chart builder and curves the lines in the chart.
var builder = Charts.newLineChart();
builder.setCurveStyle(Charts.CurveStyle.SMOOTH)

Parâmetros

NomeTipoDescrição
styleCurveStyleO estilo das curvas no gráfico.

Retornar

LineChartBuilder: esse builder, útil para encadeamentos.

Consulte também


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

NomeTipoDescrição
urlStringO URL da fonte de dados, incluindo quaisquer parâmetros de consulta.

Retornar

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

NomeTipoDescrição
tableBuilderDataTableBuilderUm 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

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

NomeTipoDescrição
tableDataTableSourceA tabela de dados a ser usada no gráfico.

Retornar

LineChartBuilder: esse builder, útil para encadeamentos.


setDataViewDefinition(dataViewDefinition)

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

Parâmetros

NomeTipoDescrição
dataViewDefinitionDataViewDefinitionUm 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

LineChartBuilder: esse builder, útil para encadeamentos.


setDimensions(width, height)

Define as dimensões do gráfico.

Parâmetros

NomeTipoDescrição
widthIntegerA largura do gráfico, em pixels.
heightIntegerA altura do gráfico, em pixels.

Retornar

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

NomeTipoDescrição
positionPositionA posição da legenda.

Retornar

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

NomeTipoDescrição
textStyleTextStyleO estilo de texto a ser usado para a legenda do gráfico.

Retornar

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

Parâmetros

NomeTipoDescrição
optionStringA opção a ser definida.
valueObjectO valor que será definido.

Retornar

LineChartBuilder: esse builder, útil para encadeamentos.


setPointStyle(style)

Define o estilo dos pontos na linha. Por padrão, os pontos não têm estilos específicos e só a linha está visível.

// Creates a line chart builder and sets large point style.
var builder = Charts.newLineChart();
builder.setPointStyle(Charts.PointStyle.LARGE);

Parâmetros

NomeTipoDescrição
stylePointStyleO estilo a ser usado para pontos na linha.

Retornar

LineChartBuilder: esse builder, útil para encadeamentos.

Consulte também


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

NomeTipoDescrição
startNumberO valor da linha de grade mais baixa do eixo do intervalo.
endNumberO valor da linha de grade mais alta do eixo do intervalo.

Retornar

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

NomeTipoDescrição
chartTitleStringo título do gráfico.

Retornar

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

NomeTipoDescrição
textStyleTextStyleO estilo de texto a ser usado no título do gráfico. É possível criar um objeto TextStyleBuilder chamando Charts.newTextStyle().

Retornar

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

NomeTipoDescrição
textStyleTextStyleO estilo de texto a ser usado no título do eixo horizontal. É possível criar um objeto TextStyleBuilder chamando Charts.newTextStyle().

Retornar

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

NomeTipoDescrição
titleStringO título do eixo X.

Retornar

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

NomeTipoDescrição
textStyleTextStyleO estilo de texto a ser usado no título do eixo horizontal. É possível criar um objeto TextStyleBuilder chamando Charts.newTextStyle().

Retornar

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

NomeTipoDescrição
textStyleTextStyleO estilo de texto a ser usado no título do eixo horizontal. É possível criar um objeto TextStyleBuilder chamando Charts.newTextStyle().

Retornar

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

NomeTipoDescrição
titleStringTítulo do eixo Y.

Retornar

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

NomeTipoDescrição
textStyleTextStyleO estilo de texto a ser usado no título do eixo horizontal. É possível criar um objeto TextStyleBuilder chamando Charts.newTextStyle().

Retornar

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

LineChartBuilder: esse builder, útil para encadeamentos.