스프레드시트의 시트 위에 있는 그림을 나타냅니다.
방법
| 메서드 | 반환 유형 | 간략한 설명 |
|---|---|---|
getContainerInfo() | ContainerInfo | 시트에서 그림이 배치되는 위치에 대한 정보를 가져옵니다. |
getHeight() | Integer | 그림의 실제 높이를 픽셀 단위로 반환합니다. |
getOnAction() | String | 이 그림에 연결된 매크로의 이름을 반환합니다. |
getSheet() | Sheet | 이 그림이 표시되는 시트를 반환합니다. |
getWidth() | Integer | 그림의 실제 너비를 픽셀 단위로 반환합니다. |
getZIndex() | Number | 이 그림의 Z-색인을 반환합니다. |
remove() | void | 스프레드시트에서 이 그림을 삭제합니다. |
setHeight(height) | Drawing | 그림의 실제 높이를 픽셀 단위로 설정합니다. |
setOnAction(macroName) | Drawing | 이 그림에 매크로 함수를 할당합니다. |
setPosition(anchorRowPos, anchorColPos, offsetX, offsetY) | Drawing | 시트에서 그림을 표시할 위치를 설정합니다. |
setWidth(width) | Drawing | 그림의 실제 너비를 픽셀 단위로 설정합니다. |
setZIndex(zIndex) | Drawing | 이 그림의 Z-색인을 설정합니다. |
자세한 문서
getContainerInfo()
시트에서 그림이 배치되는 위치에 대한 정보를 가져옵니다.
리턴
ContainerInfo - 그림의 컨테이너 위치가 포함된 객체입니다.
승인
이 방법을 사용하는 스크립트는 다음 범위 중 하나 이상을 승인해야 합니다.
-
https://www.googleapis.com/auth/spreadsheets.currentonly -
https://www.googleapis.com/auth/spreadsheets
getHeight()
그림의 실제 높이를 픽셀 단위로 반환합니다.
// Logs the height of all drawings in a sheet
var drawings = SpreadsheetApp.getActiveSheet().getDrawings();
for (var i = 0; i < drawings.length; i++) {
Logger.log(drawings[i].getHeight());
}
리턴
Integer - 그림의 높이(픽셀)입니다.
승인
이 방법을 사용하는 스크립트는 다음 범위 중 하나 이상을 승인해야 합니다.
-
https://www.googleapis.com/auth/spreadsheets.currentonly -
https://www.googleapis.com/auth/spreadsheets
getOnAction()
이 그림에 연결된 매크로의 이름을 반환합니다.
// Logs the macro name of all drawings on the active sheet.
var drawings = SpreadsheetApp.getActiveSheet().getDrawings();
for (var i = 0; i < drawings.length; i++) {
Logger.log(drawings[i].getOnAction());
}
리턴
String - 이 그림에 연결된 매크로 이름입니다.
승인
이 방법을 사용하는 스크립트는 다음 범위 중 하나 이상을 승인해야 합니다.
-
https://www.googleapis.com/auth/spreadsheets.currentonly -
https://www.googleapis.com/auth/spreadsheets
getSheet()
이 그림이 표시되는 시트를 반환합니다.
// Logs the parent sheet of all drawings on the active sheet.
var drawings = SpreadsheetApp.getActiveSheet().getDrawings();
for (var i = 0; i < drawings.length; i++) {
Logger.log(drawings[i].getSheet());
}
리턴
Sheet - 그림이 표시되는 시트입니다.
승인
이 방법을 사용하는 스크립트는 다음 범위 중 하나 이상을 승인해야 합니다.
-
https://www.googleapis.com/auth/spreadsheets.currentonly -
https://www.googleapis.com/auth/spreadsheets
getWidth()
그림의 실제 너비를 픽셀 단위로 반환합니다.
// Logs the width of all drawings in a sheet
var drawings = SpreadsheetApp.getActiveSheet().getDrawings();
for (var i = 0; i < drawings.length; i++) {
Logger.log(drawings[i].getWidth());
}
리턴
Integer - 그림의 너비(픽셀)입니다.
승인
이 방법을 사용하는 스크립트는 다음 범위 중 하나 이상을 승인해야 합니다.
-
https://www.googleapis.com/auth/spreadsheets.currentonly -
https://www.googleapis.com/auth/spreadsheets
getZIndex()
이 그림의 Z-색인을 반환합니다.
// Logs the z-index of all drawings on the active sheet.
var drawings = SpreadsheetApp.getActiveSheet().getDrawings();
for (var i = 0; i < drawings.length; i++) {
Logger.log(drawings[i].getZIndex());
}
리턴
Number — 이 그림의 Z-색인입니다.
승인
이 방법을 사용하는 스크립트는 다음 범위 중 하나 이상을 승인해야 합니다.
-
https://www.googleapis.com/auth/spreadsheets.currentonly -
https://www.googleapis.com/auth/spreadsheets
remove()
스프레드시트에서 이 그림을 삭제합니다. 그리기에 추가 작업을 하면 스크립트 오류가 발생합니다.
// Deletes all drawings from the active sheet.
var drawings = SpreadsheetApp.getActiveSheet().getDrawings();
for (var i = 0; i < drawings.length; i++) {
drawings[i].remove();
}
승인
이 방법을 사용하는 스크립트는 다음 범위 중 하나 이상을 승인해야 합니다.
-
https://www.googleapis.com/auth/spreadsheets.currentonly -
https://www.googleapis.com/auth/spreadsheets
setHeight(height)
setOnAction(macroName)
setPosition(anchorRowPos, anchorColPos, offsetX, offsetY)
시트에서 그림을 표시할 위치를 설정합니다. 앵커 행 및 열 위치 색인은 1부터 색인이 생성됩니다.
매개변수
| 이름 | 유형 | 설명 |
|---|---|---|
anchorRowPos | Integer | 그림의 상단은 이 행에 고정됩니다. |
anchorColPos | Integer | 그림의 상단은 이 열에 고정됩니다. |
offsetX | Integer | 셀 모서리로부터의 가로 오프셋(픽셀)입니다. |
offsetY | Integer | 셀 모서리로부터의 세로 오프셋(픽셀)입니다. |
리턴
Drawing - 체이닝용 그림입니다.
승인
이 방법을 사용하는 스크립트는 다음 범위 중 하나 이상을 승인해야 합니다.
-
https://www.googleapis.com/auth/spreadsheets.currentonly -
https://www.googleapis.com/auth/spreadsheets