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
const drawings = SpreadsheetApp.getActiveSheet().getDrawings();
for (let 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.
const drawings = SpreadsheetApp.getActiveSheet().getDrawings();
for (let 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.
const drawings = SpreadsheetApp.getActiveSheet().getDrawings();
for (let 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
const drawings = SpreadsheetApp.getActiveSheet().getDrawings();
for (let 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.
const drawings = SpreadsheetApp.getActiveSheet().getDrawings();
for (let 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.
const drawings = SpreadsheetApp.getActiveSheet().getDrawings();
for (let 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: 체이닝을 위한 이 그림