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을 반환합니다. 이미지가 을 삽입하면 이 메서드는 이미지 삽입 중에 제공된 URL을 반환합니다.

리턴

String - 이미지 URL입니다(있는 경우). 이미지를 사용할 수 없거나 이미지를 사용할 수 없는 경우 null를 반환합니다. 소스 URL이 있어야 합니다

승인

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

  • 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입니다.

매개변수

이름유형설명
blobBlobSourceBlob 형식의 새 이미지입니다.

리턴

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