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)

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

매개변수

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

Return

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

승인

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

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

setOnAction(macroName)

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

매개변수

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

Return

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

setPosition(anchorRowPos, anchorColPos, offsetX, offsetY)

시트에서 그림이 표시되는 위치를 설정합니다. 앵커 행과 열 색인 색인은 1 색인이 생성됩니다.

매개변수

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

Return

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

승인

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

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

setWidth(width)

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

매개변수

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

Return

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

승인

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

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

setZIndex(zIndex)

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

매개변수

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

Return

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