스프레드시트에서 시트 위의 그림을 나타냅니다.
메서드
메서드 | 반환 유형 | 간략한 설명 |
---|---|---|
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