Class EmbeddedAreaChartBuilder

이 빌더로 수정하는 차트에 범위를 추가합니다. 이미 추가된 경우 범위를 추가하지 않습니다. 차트에 추가됩니다.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

var chart = sheet.newChart()
    .setChartType(Charts.ChartType.BAR)
    .addRange(sheet.getRange("A1:B8"))
    .setPosition(5, 5, 0, 0)
    .build();

sheet.insertChart(chart);

매개변수

리턴

EmbeddedChartBuilder: 체이닝을 위한 이 빌더

차트 유형을 AreaChart로 설정하고 EmbeddedAreaChartBuilder를 반환합니다.

리턴

EmbeddedAreaChartBuilder: 영역 차트 빌더입니다.

차트 유형을 BarChart로 설정하고 EmbeddedBarChartBuilder를 반환합니다.

리턴

EmbeddedBarChartBuilder: 막대 그래프 빌더입니다.

차트 유형을 ColumnChart로 설정하고 EmbeddedColumnChartBuilder을 반환합니다.

리턴

EmbeddedColumnChartBuilder: 열 차트 빌더입니다.

차트 유형을 ComboChart로 설정하고 EmbeddedComboChartBuilder을 반환합니다.

리턴

EmbeddedComboChartBuilder: 콤보 차트 빌더

차트 유형을 HistogramChart로 설정하고 EmbeddedHistogramChartBuilder를 반환합니다.

리턴

EmbeddedHistogramChartBuilder: 히스토그램 차트 빌더

차트 유형을 LineChart로 설정하고 EmbeddedLineChartBuilder를 반환합니다.

리턴

EmbeddedLineChartBuilder: 선 차트 작성 도구

차트 유형을 PieChart로 설정하고 EmbeddedPieChartBuilder를 반환합니다.

리턴

EmbeddedPieChartBuilder: 원형 차트 빌더

차트 유형을 ScatterChart로 설정하고 EmbeddedScatterChartBuilder을 반환합니다.

리턴

EmbeddedScatterChartBuilder: 분산형 차트 빌더

차트 유형을 TableChart로 설정하고 EmbeddedTableChartBuilder를 반환합니다.

리턴

EmbeddedTableChartBuilder: 표 차트 빌더입니다.

모든 변경사항을 반영하도록 차트를 빌드합니다.

이 방법은 스프레드시트 위에 차트를 자동으로 그리지 않습니다. 새 차트 sheet.insertChart(chart)를 통해 삽입해야 하며 기존 차트를 업데이트해야 합니다. sheet.updateChart(chart)을(를) 통해

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

var range = sheet.getRange("A1:B5");
var chart = sheet.newChart()
    .setChartType(Charts.ChartType.BAR)
    .addRange(range)
    .setPosition(5, 5, 0, 0)
    .build();

sheet.insertChart(chart);

리턴

EmbeddedChart: 생성된 차트로, 여전히 스프레드시트에 추가해야 합니다.

이 빌더가 수정하는 차트에서 모든 범위를 삭제합니다.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

// This code updates the chart to use only the new ranges while preserving the existing
// formatting of the chart.
var chart = sheet.getCharts()[0];
var newChart = chart
    .modify()
    .clearRanges()
    .addRange(sheet.getRange("A1:A5"))
    .addRange(sheet.getRange("B1:B5"))
    .build();
sheet.updateChart(newChart);

리턴

EmbeddedChartBuilder: 체이닝을 위한 이 빌더

현재 차트 유형을 반환합니다.

리턴

ChartType: 차트 유형

차트가 표시되는 위치를 캡슐화하는 ContainerInfo 차트를 반환합니다. 시트입니다.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

var chartBuilder = sheet.newChart()
    .setChartType(Charts.ChartType.BAR)
    .addRange(sheet.getRange("A1:B8"))
    .setPosition(5, 5, 0, 0);

// This method returns the exact same data as Chart#getContainerInfo()
var containerInfo = chartBuilder.getContainer();

// Logs the values we used in setPosition()
Logger.log("Anchor Column: %s\r\nAnchor Row %s\r\nOffset X %s\r\nOffset Y %s",
          containerInfo.getAnchorColumn(),
          containerInfo.getAnchorRow(),
          containerInfo.getOffsetX(),
          containerInfo.getOffsetY());

리턴

ContainerInfo: 차트 컨테이너의 위치가 포함된 객체

현재 이 차트에 데이터를 제공하고 있는 범위 목록의 사본을 반환합니다. addRange(range) 및 removeRange(range)를 사용하여 이 목록을 수정하세요.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

var chartBuilder = sheet.newChart()
    .setChartType(Charts.ChartType.BAR)
    .addRange(sheet.getRange("A1:B8"))
    .setPosition(5, 5, 0, 0);

var ranges = chartBuilder.getRanges();

// There's only one range as a data source for this chart,
// so this logs "A1:B8"
for (var i in ranges) {
  var range = ranges[i];
  Logger.log(range.getA1Notation());
}

리턴

Range[]: 빌드할 차트의 데이터 소스 역할을 하는 범위의 배열

이 빌더가 수정하는 차트에서 지정된 범위를 삭제합니다. 다음 경우에는 오류가 발생하지 않습니다. 범위가 이 차트에 없는 경우

삭제된 범위는 addRange(range)를 통해 추가된 범위와 일치해야 합니다. 그렇지 않으면 차트에 변경사항이 없습니다. 이 메서드는 값을 부분적으로 삭제하는 데 사용할 수 없습니다. 확인할 수 있습니다

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

var firstRange = sheet.getRange("A1:B5");
var secondRange = sheet.getRange("A6:B8");

var chartBuilder = sheet.newChart()
    .setChartType(Charts.ChartType.BAR)
    .addRange(firstRange)
    // This range will render in a different color
    .addRange(secondRange)
    .setPosition(5, 5, 0, 0);

// Note that you can use either of these two formats, but the range
// MUST match up with a range that was added via addRange(), or it
// will not be removed, and will not throw an exception
chartBuilder.removeRange(firstRange);
chartBuilder.removeRange(sheet.getRange("A6:B8"));

var chart = chartBuilder.build();

sheet.insertChart(chart);

매개변수

리턴

EmbeddedChartBuilder: 체이닝을 위한 이 빌더

정의역축의 계열 그리기를 반전합니다. 세로 범위 차트 (예: 선, 영역 또는 열 차트)의 경우 가로축이 오른쪽에서 왼쪽으로 그려집니다. 대상 가로축 차트 (예: 막대 그래프)는 세로축이 위에서 쪽으로 있습니다. 원형 차트의 경우 슬라이스가 시계 반대 방향으로 그려집니다.

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

리턴

EmbeddedAreaChartBuilder - 체이닝에 유용한 빌더입니다.

차트의 배경 색상을 설정합니다.

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

매개변수

리턴

EmbeddedAreaChartBuilder - 체이닝에 유용한 빌더입니다.

차트 유형을 변경합니다. 현재 일부 삽입된 차트 유형은 지원되지 않습니다. ChartType를 참조하세요.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

var range = sheet.getRange("A1:B5");
var chart = sheet.newChart()
    .setChartType(Charts.ChartType.BAR)
    .addRange(range)
    .setPosition(5, 5, 0, 0)
    .build();

sheet.insertChart(chart);

매개변수

리턴

EmbeddedChartBuilder: 체이닝을 위한 이 빌더

차트의 선 색상을 설정합니다.

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

매개변수

리턴

EmbeddedAreaChartBuilder - 체이닝에 유용한 빌더입니다.

숨겨진 행과 열에 사용할 전략을 설정합니다. 기본값은 IGNORE_ROWS입니다.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

var range = sheet.getRange("A1:B5");
var chart = sheet.newChart()
    .setChartType(Charts.ChartType.BAR)
    .addRange(range)
    .setHiddenDimensionStrategy(Charts.ChartHiddenDimensionStrategy.IGNORE_COLUMNS)
    .setPosition(5, 5, 0, 0)
    .build();

sheet.insertChart(chart);

매개변수

리턴

EmbeddedChartBuilder: 체이닝을 위한 이 빌더

차트를 기준으로 범례의 위치를 설정합니다. 기본적으로 범례는 없습니다.

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

매개변수

리턴

EmbeddedAreaChartBuilder - 체이닝에 유용한 빌더입니다.

차트 범례의 텍스트 스타일을 설정합니다.

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

매개변수

리턴

EmbeddedAreaChartBuilder - 체이닝에 유용한 빌더입니다.

두 개 이상의 범위가 있는 경우 사용할 병합 전략을 설정합니다. MERGE_ROWS인 경우 행이 병합됩니다. MERGE_COLUMNS인 경우 열이 병합됩니다. 기본값은 MERGE_COLUMNS입니다.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

var range = sheet.getRange("A1:B10");
var range2 = sheet.getRange("C:C10");
var chart = sheet.newChart()
    .setChartType(Charts.ChartType.BAR)
    .addRange(range)
    .addRange(range2)
    .setMergeStrategy(Charts.ChartMergeStrategy.MERGE_ROWS)
    .setPosition(5, 5, 0, 0)
    .build();

sheet.insertChart(chart);

매개변수

리턴

EmbeddedChartBuilder: 체이닝을 위한 이 빌더

헤더로 처리할 범위 내 행 또는 열의 개수를 설정합니다.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

var range = sheet.getRange("A1:B5");
var chart = sheet.newChart()
    .setChartType(Charts.ChartType.BAR)
    .addRange(range)
    .setNumHeaders(1)
    .setPosition(5, 5, 0, 0)
    .build();

sheet.insertChart(chart);

매개변수

리턴

EmbeddedChartBuilder: 체이닝을 위한 이 빌더

이 차트의 고급 옵션을 설정합니다. 사용 가능한 옵션의 목록을 보려면 차트 구성 옵션을 참조하세요.

이 메서드는 지정한 옵션이 이 차트 유형에 유효하거나 값이 올바른 형식/구조인지 확인합니다.

이 예에서는 제목을 변경하고 범례를 설정하는 방법을 보여줍니다.

builder.setOption('title', 'Earnings projections');
builder.setOption('legend', {position: 'top', textStyle: {color: 'blue', fontSize: 16}});

매개변수

리턴

EmbeddedChartBuilder - 체이닝을 위한 빌더입니다.

선에 있는 점의 스타일을 설정합니다. 기본적으로 점에는 특정 스타일이 없으며 선이 보입니다.

// Creates a line chart builder and sets large point style.
var builder = Charts.newLineChart();
builder.setPointStyle(Charts.PointStyle.LARGE);

매개변수

리턴

EmbeddedAreaChartBuilder - 체이닝에 유용한 빌더입니다.

참고 항목

• PointStyle

시트에서 차트가 표시되는 위치를 변경하여 위치를 설정합니다. anchorRowPos 및 anchorColPos는 1부터 색인이 생성됩니다.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

var range = sheet.getRange("A1:B5");
var chart = sheet.newChart()
    .setChartType(Charts.ChartType.BAR)
    .addRange(range)
    .setPosition(5, 5, 0, 0)
    .build();

sheet.insertChart(chart);

매개변수

리턴

EmbeddedChartBuilder: 체이닝을 위한 이 빌더

차트의 범위를 설정합니다.

데이터 포인트가 범위를 벗어나는 경우 해당 데이터를 포함하도록 범위가 확장됩니다. 포인트

매개변수

리턴

EmbeddedAreaChartBuilder - 체이닝에 유용한 빌더입니다.

누적 선을 사용합니다. 즉, 선과 막대 값이 누적 (누적)됩니다. 기본적으로 스태킹이 없습니다.

리턴

EmbeddedAreaChartBuilder - 체이닝에 유용한 빌더입니다.

차트의 제목을 설정합니다. 제목은 차트 위 중앙에 표시됩니다.

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

매개변수

리턴

EmbeddedAreaChartBuilder - 체이닝에 유용한 빌더입니다.

차트 제목의 텍스트 스타일을 설정합니다.

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

매개변수

리턴

EmbeddedAreaChartBuilder - 체이닝에 유용한 빌더입니다.

차트의 행과 열을 바꿀지 여부를 설정합니다. true로 설정하면 행 및 열이 전환됩니다. 기본값은 false입니다.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

var range = sheet.getRange("A1:B5");
var chart = sheet.newChart()
    .setChartType(Charts.ChartType.BAR)
    .addRange(range)
    .setTransposeRowsAndColumns(true)
    .setPosition(5, 5, 0, 0)
    .build();

sheet.insertChart(chart);

매개변수

리턴

EmbeddedChartBuilder: 체이닝을 위한 이 빌더

가로축 텍스트 스타일을 설정합니다.

// Creates a line chart builder and sets the X-axis text style to blue, 18-point font.
var textStyle = Charts.newTextStyle().setColor('blue').setFontSize(18).build();
var builder = Charts.newLineChart();
builder.setXAxisTextStyle(textStyle);

매개변수

리턴

EmbeddedAreaChartBuilder - 체이닝에 유용한 빌더입니다.

가로축에 제목을 추가합니다. 제목이 중앙에 표시되며 축 값 아래에 표시됩니다. 라벨을 지정합니다

// Creates a line chart builder and sets the X-axis title.
var builder = Charts.newLineChart();
builder.setTitle('X-axis Title')

매개변수

리턴

EmbeddedAreaChartBuilder - 체이닝에 유용한 빌더입니다.

가로축 제목 텍스트 스타일을 설정합니다.

// Creates a line chart builder and sets the X-axis title text style to blue, 18-point font.
var textStyle = Charts.newTextStyle().setColor('blue').setFontSize(18).build();
var builder = Charts.newLineChart();
builder.setXAxisTitleTextStyle(textStyle);

매개변수

리턴

EmbeddedAreaChartBuilder - 체이닝에 유용한 빌더입니다.

세로축 텍스트 스타일을 설정합니다.

// Creates a line chart builder and sets the Y-axis text style to blue, 18-point font.
var textStyle = Charts.newTextStyle().setColor('blue').setFontSize(18).build();
var builder = Charts.newLineChart();
builder.setYAxisTextStyle(textStyle);

매개변수

리턴

EmbeddedAreaChartBuilder - 체이닝에 유용한 빌더입니다.

세로축에 제목을 추가합니다. 제목이 중앙에 표시되며 값의 왼쪽에 표시됩니다. 라벨을 지정합니다

// Creates a line chart builder and sets the Y-axis title.
var builder = Charts.newLineChart();
builder.setYAxisTitle('Y-axis Title')

매개변수

리턴

EmbeddedAreaChartBuilder - 체이닝에 유용한 빌더입니다.

세로축 제목 텍스트 스타일을 설정합니다.

// Creates a line chart builder and sets the Y-axis title text style to blue, 18-point font.
var textStyle = Charts.newTextStyle().setColor('blue').setFontSize(18).build();
var builder = Charts.newLineChart();
builder.setYAxisTitleTextStyle(textStyle);

매개변수

리턴

EmbeddedAreaChartBuilder - 체이닝에 유용한 빌더입니다.

범위 축을 로그 배율로 만듭니다 (모든 값이 양수여야 함). 범위 축은 세로 차트 (예: 선, 영역, 열)의 세로축 및 가로 차트 (예: 막대)의 가로축.

리턴

EmbeddedAreaChartBuilder - 체이닝에 유용한 빌더입니다.