Class OverGridImage

OverGridImage

스프레드시트에서 그리드 위에 이미지를 나타냅니다.

방법

메서드반환 유형간략한 설명
assignScript(functionName)OverGridImage지정된 함수 이름의 함수를 이 이미지에 할당합니다.
getAltTextDescription()String이미지의 대체 텍스트 설명을 반환합니다.
getAltTextTitle()String이미지의 대체 텍스트 제목을 반환합니다.
getAnchorCell()Range이미지가 고정된 셀을 반환합니다.
getAnchorCellXOffset()Integer앵커 셀로부터 가로 픽셀 오프셋을 반환합니다.
getAnchorCellYOffset()Integer앵커 셀의 세로 픽셀 오프셋을 반환합니다.
getHeight()Integer이미지의 실제 높이를 픽셀 단위로 반환합니다.
getInherentHeight()Integer이미지의 고유 높이를 픽셀 단위로 반환합니다.
getInherentWidth()Integer이미지의 고유 높이를 픽셀 단위로 반환합니다.
getScript()String이 이미지에 할당된 함수의 이름을 반환합니다.
getSheet()Sheet이 이미지가 표시되는 시트를 반환합니다.
getUrl()String이미지의 소스 URL을 가져옵니다. URL을 사용할 수 없으면 null를 반환합니다.
getWidth()Integer이미지의 실제 너비를 픽셀 단위로 반환합니다.
remove()void스프레드시트에서 이 이미지를 삭제합니다.
replace(blob)OverGridImage이 이미지를 제공된 BlobSource로 지정된 이미지로 바꿉니다.
replace(url)OverGridImage이 이미지를 지정된 URL의 이미지로 바꿉니다.
resetSize()OverGridImage이 이미지를 원래 크기로 재설정합니다.
setAltTextDescription(description)OverGridImage이미지에 대체 텍스트 설명을 설정합니다.
setAltTextTitle(title)OverGridImage이미지의 대체 텍스트 제목을 설정합니다.
setAnchorCell(cell)OverGridImage이미지가 고정되는 셀을 설정합니다.
setAnchorCellXOffset(offset)OverGridImage앵커 셀로부터 가로 픽셀 오프셋을 설정합니다.
setAnchorCellYOffset(offset)OverGridImage앵커 셀로부터 세로 픽셀 오프셋을 설정합니다.
setHeight(height)OverGridImage이미지의 실제 높이를 픽셀 단위로 설정합니다.
setWidth(width)OverGridImage이미지의 실제 너비를 픽셀 단위로 설정합니다.

자세한 문서

assignScript(functionName)

지정된 함수 이름의 함수를 이 이미지에 할당합니다.

매개변수

이름유형설명
functionNameString지정 중인 함수의 이름입니다. privateFunction_와 같이 밑줄로 끝나는 함수가 아니라 공개된 최상위 수준 함수여야 합니다.

리턴

OverGridImage - 체이닝용 이미지입니다.

승인

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

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

getAltTextDescription()

이미지의 대체 텍스트 설명을 반환합니다.

리턴

String - 대체 텍스트 설명입니다.

승인

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

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

getAltTextTitle()

이미지의 대체 텍스트 제목을 반환합니다.

리턴

String - 대체 텍스트 제목입니다.

승인

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

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

getAnchorCell()

이미지가 고정된 셀을 반환합니다.

리턴

Range - 앵커 셀입니다.

승인

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

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

getAnchorCellXOffset()

앵커 셀로부터 가로 픽셀 오프셋을 반환합니다.

리턴

Integer - 가로 픽셀 오프셋입니다.

승인

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

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

getAnchorCellYOffset()

앵커 셀의 세로 픽셀 오프셋을 반환합니다.

리턴

Integer - 세로 픽셀 오프셋입니다.

승인

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

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

getHeight()

이미지의 실제 높이를 픽셀 단위로 반환합니다.

// Logs the height of all images in a spreadsheet
var images = SpreadsheetApp.getActiveSpreadsheet().getImages();
for (var i = 0; i < images.length; i++) {
  Logger.log(images[i].getHeight());
}

리턴

Integer - 이미지의 높이(픽셀)입니다.

승인

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

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

getInherentHeight()

이미지의 고유 높이를 픽셀 단위로 반환합니다.

리턴

Integer - 픽셀 단위의 고유 높이입니다.

승인

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

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

getInherentWidth()

이미지의 고유 높이를 픽셀 단위로 반환합니다.

리턴

Integer - 픽셀 단위의 고유 너비입니다.

승인

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

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

getScript()

이 이미지에 할당된 함수의 이름을 반환합니다.

리턴

String - 함수의 이름입니다.

승인

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

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

getSheet()

이 이미지가 표시되는 시트를 반환합니다.

// Logs the parent sheet of all images in a spreadsheet
var images = SpreadsheetApp.getActiveSpreadsheet().getImages();
for (var i = 0; i < images.length; i++) {
  Logger.log(images[i].getSheet());
}

리턴

Sheet - 이미지가 표시되는 시트입니다.

승인

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

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

getUrl()

이미지의 소스 URL을 가져옵니다. URL을 사용할 수 없으면 null를 반환합니다. API를 사용하여 URL로 이미지를 삽입한 경우 이 메서드는 이미지 삽입 중에 제공된 URL을 반환합니다.

리턴

String - 이미지 URL(사용 가능한 경우). 이미지를 사용할 수 없거나 소스 URL이 없으면 null를 반환합니다.

승인

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

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

getWidth()

이미지의 실제 너비를 픽셀 단위로 반환합니다.

// Logs the width of all images in a spreadsheet
var images = SpreadsheetApp.getActiveSpreadsheet().getImages();
for (var i = 0; i < images.length; i++) {
  Logger.log(images[i].getWidth());
}

리턴

Integer - 이미지의 너비(픽셀)입니다.

승인

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

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

remove()

스프레드시트에서 이 이미지를 삭제합니다. 이미지에 추가 작업을 하면 스크립트 오류가 발생합니다.

// Deletes all images in a spreadsheet
var images = SpreadsheetApp.getActiveSpreadsheet().getImages();
for (var i = 0; i < images.length; i++) {
  images[i].remove();
}

승인

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

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

replace(blob)

이 이미지를 제공된 BlobSource로 지정된 이미지로 바꿉니다. 지원되는 최대 blob 크기는 2MB입니다.

매개변수

이름유형설명
blobBlobSource새 이미지는 Blob입니다.

리턴

OverGridImage - 체이닝용 이미지입니다.

승인

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

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

replace(url)

이 이미지를 지정된 URL의 이미지로 바꿉니다.

매개변수

이름유형설명
urlString새 이미지의 URL입니다.

리턴

OverGridImage - 체이닝용 이미지입니다.

승인

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

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

resetSize()

이 이미지를 원래 크기로 재설정합니다.

리턴

OverGridImage - 체이닝용 이미지입니다.

승인

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

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

setAltTextDescription(description)

이미지에 대체 텍스트 설명을 설정합니다.

매개변수

이름유형설명
descriptionString이미지의 새로운 대체 텍스트 설명입니다.

리턴

OverGridImage - 체이닝용 이미지입니다.

승인

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

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

setAltTextTitle(title)

이미지의 대체 텍스트 제목을 설정합니다.

매개변수

이름유형설명
titleString이미지의 새로운 대체 텍스트 제목입니다.

리턴

OverGridImage - 체이닝용 이미지입니다.

승인

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

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

setAnchorCell(cell)

이미지가 고정되는 셀을 설정합니다.

매개변수

이름유형설명
cellRange새 앵커 셀입니다.

리턴

OverGridImage - 체이닝용 이미지입니다.

승인

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

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

setAnchorCellXOffset(offset)

앵커 셀로부터 가로 픽셀 오프셋을 설정합니다.

매개변수

이름유형설명
offsetInteger새 가로 픽셀 오프셋입니다.

리턴

OverGridImage - 체이닝용 이미지입니다.

승인

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

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

setAnchorCellYOffset(offset)

앵커 셀로부터 세로 픽셀 오프셋을 설정합니다.

매개변수

이름유형설명
offsetInteger새 세로 픽셀 오프셋입니다.

리턴

OverGridImage - 체이닝용 이미지입니다.

승인

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

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

setHeight(height)

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

매개변수

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

리턴

OverGridImage - 체이닝용 이미지입니다.

승인

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

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

setWidth(width)

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

매개변수

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

리턴

OverGridImage - 체이닝용 이미지입니다.

승인

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

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