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แสดงชีตที่รูปภาพนี้ปรากฏ
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 — รูปภาพนี้สำหรับการเชื่อมโยง

การให้สิทธิ์

สคริปต์ที่ใช้วิธีนี้ต้องมีการให้สิทธิ์ที่มีขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

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

getAltTextDescription()

แสดงคำอธิบายข้อความแสดงแทนสำหรับรูปภาพนี้

รีเทิร์น

String — คำอธิบายข้อความแสดงแทน

การให้สิทธิ์

สคริปต์ที่ใช้วิธีนี้ต้องมีการให้สิทธิ์ที่มีขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

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

getAltTextTitle()

แสดงชื่อข้อความแสดงแทนสำหรับรูปภาพนี้

รีเทิร์น

String - ชื่อข้อความแสดงแทน

การให้สิทธิ์

สคริปต์ที่ใช้วิธีนี้ต้องมีการให้สิทธิ์ที่มีขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

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

getAnchorCell()

แสดงผลเซลล์ที่ตรึงรูปภาพไว้

รีเทิร์น

Range — เซลล์หลัก

การให้สิทธิ์

สคริปต์ที่ใช้วิธีนี้ต้องมีการให้สิทธิ์ที่มีขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

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

getAnchorCellXOffset()

แสดงผลออฟเซ็ตพิกเซลแนวนอนจากเซลล์ยึด

รีเทิร์น

Integer — ออฟเซ็ตพิกเซลแนวนอน

การให้สิทธิ์

สคริปต์ที่ใช้วิธีนี้ต้องมีการให้สิทธิ์ที่มีขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

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

getAnchorCellYOffset()

แสดงผลออฟเซ็ตพิกเซลแนวตั้งจากเซลล์ยึด

รีเทิร์น

Integer — ออฟเซ็ตพิกเซลแนวตั้ง

การให้สิทธิ์

สคริปต์ที่ใช้วิธีนี้ต้องมีการให้สิทธิ์ที่มีขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

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

getHeight()

แสดงความสูงจริงของรูปภาพนี้เป็นพิกเซล 

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

รีเทิร์น

Integer — ความสูงของรูปภาพเป็นพิกเซล

การให้สิทธิ์

สคริปต์ที่ใช้วิธีนี้ต้องมีการให้สิทธิ์ที่มีขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

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

getInherentHeight()

แสดงความสูงโดยธรรมชาติของรูปภาพนี้เป็นพิกเซล

รีเทิร์น

Integer — ความสูงโดยธรรมชาติในหน่วยพิกเซล

การให้สิทธิ์

สคริปต์ที่ใช้วิธีนี้ต้องมีการให้สิทธิ์ที่มีขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

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

getInherentWidth()

แสดงความสูงโดยธรรมชาติของรูปภาพนี้เป็นพิกเซล

รีเทิร์น

Integer — ความกว้างโดยธรรมชาติเป็นพิกเซล

การให้สิทธิ์

สคริปต์ที่ใช้วิธีนี้ต้องมีการให้สิทธิ์ที่มีขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

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

getScript()

แสดงชื่อของฟังก์ชันที่กำหนดให้กับรูปภาพนี้

รีเทิร์น

String — ชื่อของฟังก์ชัน

การให้สิทธิ์

สคริปต์ที่ใช้วิธีนี้ต้องมีการให้สิทธิ์ที่มีขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

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

getSheet()

แสดงชีตที่รูปภาพนี้ปรากฏ 

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

รีเทิร์น

Sheet — ชีตที่รูปภาพปรากฏ

การให้สิทธิ์

สคริปต์ที่ใช้วิธีนี้ต้องมีการให้สิทธิ์ที่มีขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

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

getWidth()

แสดงผลความกว้างจริงของรูปภาพนี้เป็นพิกเซล 

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

รีเทิร์น

Integer — ความกว้างของรูปภาพเป็นพิกเซล

การให้สิทธิ์

สคริปต์ที่ใช้วิธีนี้ต้องมีการให้สิทธิ์ที่มีขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

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

remove()

ลบรูปภาพนี้ออกจากสเปรดชีต การดำเนินการเพิ่มเติมใดๆ ในรูปภาพจะทำให้เกิดข้อผิดพลาดของสคริปต์ 

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

การให้สิทธิ์

สคริปต์ที่ใช้วิธีนี้ต้องมีการให้สิทธิ์ที่มีขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

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

replace(blob)

แทนที่รูปภาพนี้ด้วยรูปภาพที่ระบุโดย BlobSource ที่ให้ไว้ ขนาดของ BLOB ต้องไม่เกิน 2 MB

พารามิเตอร์

ชื่อประเภทคำอธิบาย
blobBlobSourceรูปภาพใหม่เป็น Blob

รีเทิร์น

OverGridImage — รูปภาพนี้สำหรับการเชื่อมโยง

การให้สิทธิ์

สคริปต์ที่ใช้วิธีนี้ต้องมีการให้สิทธิ์ที่มีขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

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

replace(url)

แทนที่รูปภาพนี้ด้วยรูปภาพจาก URL ที่ระบุ

พารามิเตอร์

ชื่อประเภทคำอธิบาย
urlStringURL ของรูปภาพใหม่

รีเทิร์น

OverGridImage — รูปภาพนี้สำหรับการเชื่อมโยง

การให้สิทธิ์

สคริปต์ที่ใช้วิธีนี้ต้องมีการให้สิทธิ์ที่มีขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

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

resetSize()

รีเซ็ตรูปภาพนี้เป็นขนาดเดิม

รีเทิร์น

OverGridImage — รูปภาพนี้สำหรับการเชื่อมโยง

การให้สิทธิ์

สคริปต์ที่ใช้วิธีนี้ต้องมีการให้สิทธิ์ที่มีขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

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

setAltTextDescription(description)

ตั้งค่าคำอธิบายข้อความแสดงแทนสำหรับรูปภาพนี้

พารามิเตอร์

ชื่อประเภทคำอธิบาย
descriptionStringคำอธิบายข้อความแสดงแทนใหม่สำหรับรูปภาพ

รีเทิร์น

OverGridImage — รูปภาพนี้สำหรับการเชื่อมโยง

การให้สิทธิ์

สคริปต์ที่ใช้วิธีนี้ต้องมีการให้สิทธิ์ที่มีขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

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

setAltTextTitle(title)

ตั้งชื่อข้อความแสดงแทนสำหรับรูปภาพนี้

พารามิเตอร์

ชื่อประเภทคำอธิบาย
titleStringชื่อข้อความแสดงแทนใหม่สำหรับรูปภาพ

รีเทิร์น

OverGridImage — รูปภาพนี้สำหรับการเชื่อมโยง

การให้สิทธิ์

สคริปต์ที่ใช้วิธีนี้ต้องมีการให้สิทธิ์ที่มีขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

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

setAnchorCell(cell)

ตั้งค่าเซลล์ที่ตรึงรูปภาพไว้

พารามิเตอร์

ชื่อประเภทคำอธิบาย
cellRangeเซลล์ยึดใหม่

รีเทิร์น

OverGridImage — รูปภาพนี้สำหรับการเชื่อมโยง

การให้สิทธิ์

สคริปต์ที่ใช้วิธีนี้ต้องมีการให้สิทธิ์ที่มีขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

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

setAnchorCellXOffset(offset)

ตั้งค่าออฟเซ็ตพิกเซลแนวนอนจากเซลล์ยึด

พารามิเตอร์

ชื่อประเภทคำอธิบาย
offsetIntegerออฟเซ็ตพิกเซลแนวนอนใหม่

รีเทิร์น

OverGridImage — รูปภาพนี้สำหรับการเชื่อมโยง

การให้สิทธิ์

สคริปต์ที่ใช้วิธีนี้ต้องมีการให้สิทธิ์ที่มีขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

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

setAnchorCellYOffset(offset)

ตั้งค่าออฟเซ็ตพิกเซลแนวตั้งจากเซลล์ยึด

พารามิเตอร์

ชื่อประเภทคำอธิบาย
offsetIntegerออฟเซ็ตพิกเซลแนวตั้งใหม่

รีเทิร์น

OverGridImage — รูปภาพนี้สำหรับการเชื่อมโยง

การให้สิทธิ์

สคริปต์ที่ใช้วิธีนี้ต้องมีการให้สิทธิ์ที่มีขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

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

setHeight(height)

กำหนดความสูงจริงของรูปภาพนี้เป็นพิกเซล

พารามิเตอร์

ชื่อประเภทคำอธิบาย
heightIntegerความสูงที่ต้องการเป็นพิกเซล

รีเทิร์น

OverGridImage — รูปภาพสำหรับการเชื่อมโยง

การให้สิทธิ์

สคริปต์ที่ใช้วิธีนี้ต้องมีการให้สิทธิ์ที่มีขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

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

setWidth(width)

กำหนดความกว้างจริงของรูปภาพนี้เป็นพิกเซล

พารามิเตอร์

ชื่อประเภทคำอธิบาย
widthIntegerความกว้างที่ต้องการเป็นพิกเซล

รีเทิร์น

OverGridImage — รูปภาพสำหรับการเชื่อมโยง

การให้สิทธิ์

สคริปต์ที่ใช้วิธีนี้ต้องมีการให้สิทธิ์ที่มีขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

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

วิธีการที่เลิกใช้งานแล้ว