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()

시트에서 그림이 배치되는 위치에 대한 정보를 가져옵니다.

리턴

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)

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

매개변수

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

리턴

Drawing - 이 그림은 체이닝을 위한 것입니다.

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.

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

setOnAction(macroName)

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

매개변수

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

리턴

Drawing - 이 그림은 체이닝을 위한 것입니다.


setPosition(anchorRowPos, anchorColPos, offsetX, offsetY)

시트에서 그림이 표시되는 위치를 설정합니다. 앵커 행 및 열 위치 1부터 시작합니다.

매개변수

이름유형설명
anchorRowPosInteger그림의 상단이 이 행에 고정됩니다.
anchorColPosInteger그림의 상단이 이 열에 고정됩니다.
offsetXInteger셀 모서리로부터의 가로 오프셋(픽셀)입니다.
offsetYInteger셀 모서리로부터의 세로 오프셋(픽셀)입니다.

리턴

Drawing - 이 그림은 체이닝을 위한 것입니다.

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.

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

setWidth(width)

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

매개변수

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

리턴

Drawing - 이 그림은 체이닝을 위한 것입니다.

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.

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

setZIndex(zIndex)

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

매개변수

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

리턴

Drawing - 이 그림은 체이닝을 위한 것입니다.