此页面由 Cloud Translation API 翻译。

Class PieChartBuilder

饼图生成工具。如需了解详情，请参阅 Google 图表文档。

以下示例展示了如何构建饼图。数据是从 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();

方法

方法	返回类型	简介
`build()`	`Chart`	构建图表。
`reverseCategories()`	`PieChartBuilder`	反转域轴上的序列绘制。
`set3D()`	`PieChartBuilder`	将图表设置为三维。
`setBackgroundColor(cssValue)`	`PieChartBuilder`	设置图表的背景颜色。
`setColors(cssValues)`	`PieChartBuilder`	设置图表中线条的颜色。
`setDataSourceUrl(url)`	`PieChartBuilder`	设置数据源网址，用于从外部来源（如 Google 表格）拉取数据。
`setDataTable(tableBuilder)`	`PieChartBuilder`	使用 DataTableBuilder 设置要用于图表的数据表。
`setDataTable(table)`	`PieChartBuilder`	设置数据表，其中包含图表的线条以及 X 轴标签。
`setDataViewDefinition(dataViewDefinition)`	`PieChartBuilder`	设置要用于图表的数据视图定义。
`setDimensions(width, height)`	`PieChartBuilder`	设置图表的尺寸。
`setLegendPosition(position)`	`PieChartBuilder`	设置图例相对于图表的位置。
`setLegendTextStyle(textStyle)`	`PieChartBuilder`	设置图表图例的文本样式。
`setOption(option, value)`	`PieChartBuilder`	设置此图表的高级选项。
`setTitle(chartTitle)`	`PieChartBuilder`	设置图表的标题。
`setTitleTextStyle(textStyle)`	`PieChartBuilder`	设置图表标题的文本样式。

详细文档

`build()`

构建图表。

弃踢回攻

Chart - 一个 Chart 对象，可以嵌入到文档或界面元素中，也可以用作静态图片。

`reverseCategories()`

反转域轴上的序列绘制。对于垂直范围图表（例如折线图、面积图或柱形图），这意味着横轴从右向左绘制。对于水平范围图表（例如条形图），这意味着纵轴从上到下绘制。对于饼图，这意味着各切片按逆时针方向绘制。

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

弃踢回攻

PieChartBuilder - 此构建器，可用于链接。

`set3D()`

将图表设置为三维。

弃踢回攻

PieChartBuilder - 此构建器，可用于链接。

`setBackgroundColor(cssValue)`

设置图表的背景颜色。

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

参数

名称	类型	说明
`cssValue`	`String`	颜色的 CSS 值（例如 `"blue"` 或 `"#00f"`）。

弃踢回攻

PieChartBuilder - 此构建器，可用于链接。

`setColors(cssValues)`

设置图表中线条的颜色。

// 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"]);

参数

名称	类型	说明
`cssValues`	`String[]`	颜色 CSS 值数组，例如 `["red", "#acf"]`。数组中的第 n 个元素表示图表中第 n 条线的颜色。

弃踢回攻

PieChartBuilder - 此构建器，可用于链接。

`setDataSourceUrl(url)`

设置数据源网址，用于从外部来源（如 Google 表格）拉取数据。如果提供了数据源网址和 DataTable，系统会忽略数据源网址。

如需详细了解如何查询数据源，请参阅 Google 图表文档。

参数

名称	类型	说明
`url`	`String`	数据源网址，包括任何查询参数。

弃踢回攻

PieChartBuilder - 此构建器，可用于链接。

`setDataTable(tableBuilder)`

使用 DataTableBuilder 设置要用于图表的数据表。这是一种无需调用 build() 即可设置数据表的便捷方法。

参数

名称	类型	说明
`tableBuilder`	`DataTableBuilder`	数据表构建器。在此调用中，系统会立即创建新的数据表，因此对构建器的任何后续更新都不会反映在图表中。

弃踢回攻

PieChartBuilder - 此构建器，可用于链接。

`setDataTable(table)`

设置数据表，其中包含图表的线条以及 X 轴标签。第一列应为字符串，并包含横轴标签。后面可跟随任意数量的列，且所有列都必须是数字。每一列都显示为单独的一行。

参数

名称	类型	说明
`table`	`DataTableSource`	要用于图表的数据表。

弃踢回攻

PieChartBuilder - 此构建器，可用于链接。

`setDataViewDefinition(dataViewDefinition)`

设置要用于图表的数据视图定义。

参数

名称	类型	说明
`dataViewDefinition`	`DataViewDefinition`	一个数据视图定义对象，用于定义应从图表绘图的给定数据源派生的视图。

弃踢回攻

PieChartBuilder - 此构建器，可用于链接。

`setDimensions(width, height)`

设置图表的尺寸。

参数

名称	类型	说明
`width`	`Integer`	图表的宽度（以像素为单位）。
`height`	`Integer`	图表的高度（以像素为单位）。

弃踢回攻

PieChartBuilder - 此构建器，可用于链接。

`setLegendPosition(position)`

设置图例相对于图表的位置。默认情况下，不显示图例。

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

参数

名称	类型	说明
`position`	`Position`	图例的位置。

弃踢回攻

PieChartBuilder - 此构建器，可用于链接。

`setLegendTextStyle(textStyle)`

设置图表图例的文本样式。

// 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);

参数

名称	类型	说明
`textStyle`	`TextStyle`	用于图表图例的文本样式。

弃踢回攻

PieChartBuilder - 此构建器，可用于链接。

`setOption(option, value)`

设置此图表的高级选项。请参阅此图表的可用选项。如果指定的选项无效，此方法不会产生任何影响。

// Build a pie chart with a pretty legend.
var builder = Charts.newPieChart();
builder.setOption('legend', {textStyle: {color: 'blue', fontSize: 16}});
var chart = builder.build();

参数

名称	类型	说明
`option`	`String`	要设置的选项。
`value`	`Object`	要设置的值。

弃踢回攻

PieChartBuilder - 此构建器，可用于链接。

`setTitle(chartTitle)`

设置图表的标题。标题会显示在图表上方的中心位置。

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

参数

名称	类型	说明
`chartTitle`	`String`	图表标题。

弃踢回攻

PieChartBuilder - 此构建器，可用于链接。

`setTitleTextStyle(textStyle)`

设置图表标题的文本样式。

// 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);

参数

名称	类型	说明
`textStyle`	`TextStyle`	用于图表标题的文本样式。您可以通过调用 `Charts.newTextStyle()` 来创建 `TextStyleBuilder` 对象。

弃踢回攻

PieChartBuilder - 此构建器，可用于链接。