이 페이지는 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`	차트를 3차원으로 설정합니다.
`setBackgroundColor(cssValue)`	`PieChartBuilder`	차트의 배경 색상을 설정합니다.
`setColors(cssValues)`	`PieChartBuilder`	차트에서 선의 색상을 설정합니다.
`setDataSourceUrl(url)`	`PieChartBuilder`	Google 스프레드시트와 같은 외부 소스에서 데이터를 가져오는 데 사용되는 데이터 소스 URL을 설정합니다.
`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 - 문서 또는 UI 요소에 삽입하거나 정적 이미지로 사용할 수 있는 차트 객체입니다.

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

차트를 3차원으로 설정합니다.

리턴

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 스프레드시트와 같은 외부 소스에서 데이터를 가져오는 데 사용되는 데이터 소스 URL을 설정합니다. 데이터 소스 URL과 DataTable이 제공되는 경우 데이터 소스 URL은 무시됩니다.

데이터 소스 쿼리에 대한 자세한 내용은 Google 차트 문서를 참고하세요.

매개변수

이름	유형	설명
`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`	차트 제목에 사용할 텍스트 스타일입니다. `Charts.newTextStyle()`를 호출하여 `TextStyleBuilder` 객체를 만들 수 있습니다.

리턴

PieChartBuilder - 이 빌더로, 연결하는 데 유용합니다.