Class 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