Эта страница переведена с помощью Cloud Translation API.

Class PieChartBuilder

Конструктор круговых диаграмм. Более подробную информацию можно найти в документации Google Charts .

Вот пример, показывающий, как построить круговую диаграмму. Данные импортируются из электронной таблицы 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`	Устанавливает URL-адрес источника данных, который используется для получения данных из внешнего источника, например 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)`

Устанавливает URL-адрес источника данных, который используется для получения данных из внешнего источника, например Google Таблиц. Если указаны URL-адрес источника данных и DataTable, URL-адрес источника данных игнорируется.

Дополнительную информацию о запросах к источникам данных см. в документации Google Charts .

Параметры

Имя	Тип	Описание
`url`	`String`	URL-адрес источника данных, включая все параметры запроса.

Возвращаться

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`	Стиль текста, используемый для заголовка диаграммы. Вы можете создать объект `TextStyleBuilder` , вызвав `Charts.newTextStyle()` .

Возвращаться

PieChartBuilder — этот построитель, полезный для создания цепочек.