Esta página foi traduzida pela API Cloud Translation.

Class PieChartBuilder

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

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

  var chartBuilder = Charts.newPieChart()
      .setTitle('World Population by Continent')
      .setDimensions(600, 500)
      .set3D()
      .setDataSourceUrl(dataSourceUrl);

  var chart = chartBuilder.build();

Métodos

Método	Tipo de retorno	Breve descrição
`build()`	`Chart`	Cria o gráfico.
`reverseCategories()`	`PieChartBuilder`	Inverte o desenho das séries no eixo de domínio.
`set3D()`	`PieChartBuilder`	Define o gráfico como tridimensional.
`setBackgroundColor(cssValue)`	`PieChartBuilder`	Define a cor do plano de fundo do gráfico.
`setColors(cssValues)`	`PieChartBuilder`	Define as cores das linhas no gráfico.
`setDataSourceUrl(url)`	`PieChartBuilder`	Define o URL da fonte de dados usado para extrair dados de uma fonte externa, como o Planilhas Google.
`setDataTable(tableBuilder)`	`PieChartBuilder`	Define a tabela de dados a ser usada no gráfico usando um DataTableBuilder.
`setDataTable(table)`	`PieChartBuilder`	Define a tabela de dados que contém as linhas do gráfico, bem como os rótulos do eixo X.
`setDataViewDefinition(dataViewDefinition)`	`PieChartBuilder`	Define a definição de visualização de dados a ser usada no gráfico.
`setDimensions(width, height)`	`PieChartBuilder`	Define as dimensões do gráfico.
`setLegendPosition(position)`	`PieChartBuilder`	Define a posição da legenda em relação ao gráfico.
`setLegendTextStyle(textStyle)`	`PieChartBuilder`	Define o estilo de texto da legenda do gráfico.
`setOption(option, value)`	`PieChartBuilder`	Define opções avançadas para este gráfico.
`setTitle(chartTitle)`	`PieChartBuilder`	Define o título do gráfico.
`setTitleTextStyle(textStyle)`	`PieChartBuilder`	Define o estilo de texto do título do gráfico.

Documentação detalhada

`build()`

Cria o gráfico.

Retorno

Chart: um objeto de gráfico que pode ser incorporado a documentos, elementos da interface ou usado como imagem estática.

`reverseCategories()`

Inverte o desenho das séries no eixo de domínio. Para gráficos de intervalo vertical (como gráficos de linhas, área ou colunas), isso significa que o eixo horizontal é desenhado da direita para a esquerda. Para gráficos de intervalo horizontal (como gráficos de barras), isso significa que o eixo vertical é desenhado de cima para baixo. 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();

Retorno

PieChartBuilder: builder, útil para encadeamento.

`set3D()`

Define o gráfico como tridimensional.

Retorno

PieChartBuilder: builder, útil para encadeamento.

`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"`).

Retorno

PieChartBuilder: builder, útil para encadeamento.

`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 linha enésima no gráfico.

Retorno

PieChartBuilder: builder, útil para encadeamento.

`setDataSourceUrl(url)`

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

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

Parâmetros

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

Retorno

PieChartBuilder: builder, útil para encadeamento.

`setDataTable(tableBuilder)`

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

Parâmetros

Nome	Tipo	Descrição
`tableBuilder`	`DataTableBuilder`	Um criador de tabelas de dados. Uma nova tabela de dados é criada instantaneamente como parte dessa chamada, então qualquer atualização posterior no builder não será refletida no gráfico.

Retorno

PieChartBuilder: builder, útil para encadeamento.

`setDataTable(table)`

Define a tabela de dados que contém as linhas do gráfico, bem como os rótulos do eixo X. A primeira coluna precisa ser uma string e conter os rótulos do eixo horizontal. Qualquer número de colunas pode ser incluído, e todas precisam ser numéricas. 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.

Retorno

PieChartBuilder: builder, útil para encadeamento.

`setDataViewDefinition(dataViewDefinition)`

Define a definição de 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 precisa ser derivada da fonte de dados especificada para o desenho do gráfico.

Retorno

PieChartBuilder: builder, útil para encadeamento.

`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.

Retorno

PieChartBuilder: builder, útil para encadeamento.

`setLegendPosition(position)`

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

// 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.

Retorno

PieChartBuilder: builder, útil para encadeamento.

`setLegendTextStyle(textStyle)`

Define o estilo de 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 na legenda do gráfico.

Retorno

PieChartBuilder: builder, útil para encadeamento.

`setOption(option, value)`

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

// Build a pie chart with a pretty legend.
var builder = Charts.newPieChart();
builder.setOption('legend', {textStyle: {color: 'blue', fontSize: 16}});
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.

Retorno

PieChartBuilder: builder, útil para encadeamento.

`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`	no título do gráfico.

Retorno

PieChartBuilder: builder, útil para encadeamento.

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

Retorno

PieChartBuilder: builder, útil para encadeamento.