스프레드시트에 삽입된 차트를 나타냅니다.
다음 예에서는 기존 차트를 수정하는 방법을 보여줍니다.
var sheet = SpreadsheetApp.getActiveSheet(); var range = sheet.getRange("A2:B8") var chart = sheet.getCharts()[0]; chart = chart.modify() .addRange(range) .setOption('title', 'Updated!') .setOption('animation.duration', 500) .setPosition(2,2,0,0) .build(); sheet.updateChart(chart);
다음 예는 새 차트를 만드는 방법을 보여줍니다.
function newChart(range, sheet) { var sheet = SpreadsheetApp.getActiveSheet(); var chartBuilder = sheet.newChart(); chartBuilder.addRange(range) .setChartType(Charts.ChartType.LINE) .setOption('title', 'My Line Chart!'); sheet.insertChart(chartBuilder.build()); }
메서드
메서드 | 반환 유형 | 간략한 설명 |
---|---|---|
asDataSourceChart() | DataSourceChart | 차트가 데이터 소스 차트인 경우 데이터 소스 차트 인스턴스로 전송하거나 null
없습니다. |
getAs(contentType) | Blob | 이 객체 내의 데이터를 지정된 콘텐츠 유형으로 변환된 blob으로 반환합니다. |
getBlob() | Blob | 이 객체 내의 데이터를 blob으로 반환합니다. |
getChartId() | Integer |
차트 또는 null (차트가 스프레드시트에 없는 경우) |
getContainerInfo() | ContainerInfo | 시트 내에서 차트가 배치되는 위치에 대한 정보를 반환합니다. |
getHiddenDimensionStrategy() | ChartHiddenDimensionStrategy | 숨겨진 행과 열을 처리하는 데 사용할 전략을 반환합니다. |
getMergeStrategy() | ChartMergeStrategy | 두 개 이상의 범위가 존재하는 경우 사용되는 병합 전략을 반환합니다. |
getNumHeaders() | Integer | 헤더로 처리되는 범위의 행 또는 열의 수를 반환합니다. |
getOptions() | ChartOptions | 이 차트의 높이, 색상, 축과 같은 옵션을 반환합니다. |
getRanges() | Range[] | 이 차트에서 데이터 소스로 사용하는 범위를 반환합니다. |
getTransposeRowsAndColumns() | Boolean | true 인 경우 차트를 채우는 데 사용된 행과 열이 전환됩니다. |
modify() | EmbeddedChartBuilder | 이 차트를 수정하는 데 사용할 수 있는 EmbeddedChartBuilder 를 반환합니다. |
자세한 문서
asDataSourceChart()
getAs(contentType)
이 객체 내의 데이터를 지정된 콘텐츠 유형으로 변환된 blob으로 반환합니다. 이 메서드는 파일 이름에 적절한 확장자를 추가합니다(예: 'myfile.pdf'). 하지만 파일 이름에서 마지막 마침표 뒤에 오는 부분 (있는 경우)이 기존 교체해야 합니다. 따라서 'ShoppingList.12.25.2014' 위 이름이 아래와 같이 변경됩니다. 'ShoppingList.12.25.pdf'
전환수의 일일 할당량을 보려면 Google '서비스'로 이동합니다. 새로 생성된 Google Workspace 도메인에는 일시적으로 더 엄격한 정책이 적용될 수 있습니다. 할당량도 제공합니다
매개변수
이름 | 유형 | 설명 |
---|---|---|
contentType | String | 변환할 MIME 유형입니다. 대부분의 blob에서 'application/pdf' 는 다음과 같습니다.
유일하게 유효한 옵션입니다. BMP, GIF, JPEG, PNG 형식의 이미지인 경우 'image/bmp' , 'image/gif' , 'image/jpeg' , 'image/png' 중 어느 것이든 해당됩니다.
유효한지 확인합니다. Google Docs 문서의 경우 'text/markdown' 도 유효합니다. |
리턴
Blob
- blob 형식의 데이터입니다.
getBlob()
getChartId()
차트 또는 null
(차트가 스프레드시트에 없는 경우)
리턴
Integer
- 안정적인 차트 식별자입니다.
getContainerInfo()
시트 내에서 차트가 배치되는 위치에 대한 정보를 반환합니다.
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(); var containerInfo = chart.getContainerInfo(); // 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
: 차트 컨테이너의 위치가 포함된 객체
getHiddenDimensionStrategy()
숨겨진 행과 열을 처리하는 데 사용할 전략을 반환합니다. 기본값은 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() // Logs the strategy to use for hidden rows and columns which is // Charts.ChartHiddenDimensionStrategy.IGNORE_COLUMNS in this case. Logger.log(chart.getHiddenDimensionStrategy());
리턴
ChartHiddenDimensionStrategy
- 숨겨진 행과 열에 사용할 전략입니다.
getMergeStrategy()
두 개 이상의 범위가 존재하는 경우 사용되는 병합 전략을 반환합니다. 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("C1:C10"); var chart = sheet.newChart() .setChartType(Charts.ChartType.BAR) .addRange(range) .addRange(range2) .setMergeStrategy(Charts.ChartMergeStrategy.MERGE_ROWS) .setPosition(5, 5, 0, 0) .build() // Logs whether rows of multiple ranges are merged, which is MERGE_ROWS in this case. Logger.log(chart.getMergeStrategy());
리턴
ChartMergeStrategy
— 행이 여러 행에 병합되는 경우 MERGE_ROWS
범위 열이 병합되는 경우 MERGE_COLUMNS
여러 범위
getNumHeaders()
헤더로 처리되는 범위의 행 또는 열의 수를 반환합니다.
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() // Logs the number of rows or columns to use as headers, which is 1 in this case. Logger.log(chart.getHeaders());
리턴
Integer
- 헤더로 처리되는 행 또는 열의 수입니다. 음수 값은 헤더를 나타냅니다.
자동으로 감지됩니다
getOptions()
getRanges()
이 차트에서 데이터 소스로 사용하는 범위를 반환합니다.
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(); var ranges = chart.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[]
: 이 차트의 데이터 소스 역할을 하는 범위의 배열
getTransposeRowsAndColumns()
true
인 경우 차트를 채우는 데 사용된 행과 열이 전환됩니다. 기본값은 false
입니다.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var range = sheet.getRange("A1:B5"); var chart = sheet.newChart() .addRange(range) .setChartType(Charts.ChartType.BAR) .setTransposeRowsAndColumns(true) .setPosition(5, 5, 0, 0) .build() // Logs whether rows and columns should be transposed, which is true in this case. Logger.log(chart.getTransposeRowsAndColumns());
리턴
Boolean
: 차트를 구성하는 데 사용된 행과 열이 바뀐 경우 true
modify()
이 차트를 수정하는 데 사용할 수 있는 EmbeddedChartBuilder
를 반환합니다. sheet.updateChart(chart)
를 호출하여 변경사항을 저장합니다.
var sheet = SpreadsheetApp.getActiveSheet(); var chart = sheet.getCharts()[0]; chart = chart.modify() .setOption('width', 800) .setOption('height', 640) .setPosition(5, 5, 0, 0) .build(); sheet.updateChart(chart);
리턴
EmbeddedChartBuilder
: 삽입된 차트를 만들기 위한 빌더