Class Drawing

그리기

스프레드시트의 시트 위에 그려진 그림을 나타냅니다.

메서드

메서드	반환 유형	간략한 설명
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)

그림의 실제 높이를 픽셀 단위로 설정합니다.

매개변수

이름	유형	설명
height	Integer	원하는 높이(픽셀)입니다.

Return

Drawing: 이 그림은 체이닝용입니다.

승인

이 방법을 사용하는 스크립트에는 다음 범위 중 하나 이상을 사용하여 승인해야 합니다.

• https://www.googleapis.com/auth/spreadsheets.currentonly
• https://www.googleapis.com/auth/spreadsheets

---

setOnAction(macroName)

이 그림에 매크로 함수를 할당합니다.

매개변수

이름	유형	설명
macroName	String	매크로 함수의 이름입니다.

Return

Drawing: 이 그림은 체이닝용입니다.

---

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

---

setWidth(width)

그림의 실제 너비를 픽셀 단위로 설정합니다.

매개변수

이름	유형	설명
width	Integer	원하는 너비(픽셀)입니다.

Return

Drawing: 이 그림은 체이닝용입니다.

승인

이 방법을 사용하는 스크립트에는 다음 범위 중 하나 이상을 사용하여 승인해야 합니다.

• https://www.googleapis.com/auth/spreadsheets.currentonly
• https://www.googleapis.com/auth/spreadsheets

---

setZIndex(zIndex)

이 그림의 Z-색인을 설정합니다.

매개변수

이름	유형	설명
zIndex	Number	이 그림의 Z-색인입니다.

Return

Drawing: 이 그림은 체이닝용입니다.