이 페이지는 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 - 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과 데이터 테이블이 제공되는 경우 데이터 소스 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 - 체이닝에 유용한 빌더입니다.