스프레드시트의 시트 위에 그려진 그림을 나타냅니다.
메서드
메서드 | 반환 유형 | 간략한 설명 |
---|---|---|
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()
시트에서 그림의 위치에 관한 정보를 가져옵니다.
Return
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()); }
Return
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()); }
Return
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()); }
Return
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()); }
Return
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()); }
Return
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 | 셀 모서리로부터의 세로 오프셋(픽셀)입니다. |
Return
Drawing
: 이 그림은 체이닝용입니다.
승인
이 방법을 사용하는 스크립트에는 다음 범위 중 하나 이상을 사용하여 승인해야 합니다.
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets