Class OverGridImage

OverGridImage

แสดงรูปภาพในตารางกริดในสเปรดชีต

เมธอด

วิธีการประเภทการแสดงผลรายละเอียดแบบย่อ
assignScript(functionName)OverGridImageกำหนดฟังก์ชันด้วยชื่อฟังก์ชันที่ระบุให้กับอิมเมจนี้
getAltTextDescription()Stringแสดงคำอธิบายข้อความแสดงแทนสำหรับรูปภาพนี้
getAltTextTitle()Stringแสดงชื่อข้อความแสดงแทนสำหรับรูปภาพนี้
getAnchorCell()Rangeแสดงผลเซลล์ที่ตรึงรูปภาพไว้
getAnchorCellXOffset()Integerแสดงค่าออฟเซ็ตพิกเซลแนวนอนจาก Anchorเซลล์
getAnchorCellYOffset()Integerแสดงค่าออฟเซ็ตพิกเซลแนวตั้งจากสมอเซลล์
getHeight()Integerแสดงความสูงที่แท้จริงของภาพนี้เป็นพิกเซล
getInherentHeight()Integerแสดงผลความสูงโดยธรรมชาติของรูปภาพนี้เป็นพิกเซล
getInherentWidth()Integerแสดงผลความสูงโดยธรรมชาติของรูปภาพนี้เป็นพิกเซล
getScript()Stringแสดงชื่อฟังก์ชันที่กำหนดให้กับรูปภาพนี้
getSheet()Sheetแสดงชีตที่รูปภาพนี้ปรากฏขึ้น
getUrl()Stringรับ URL แหล่งที่มาของรูปภาพ แสดงผล null หาก URL ไม่พร้อมใช้งาน
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()

แสดงค่าออฟเซ็ตพิกเซลแนวนอนจาก Anchorเซลล์

รีเทิร์น

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
var images = SpreadsheetApp.getActiveSpreadsheet().getImages();
for (var 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
var images = SpreadsheetApp.getActiveSpreadsheet().getImages();
for (var 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

getUrl()

รับ URL แหล่งที่มาของรูปภาพ แสดงผล null หาก URL ไม่พร้อมใช้งาน หากรูปภาพคือ แทรกโดย URL โดยใช้ API วิธีนี้จะแสดง URL ที่ให้ไว้ในระหว่างการแทรกรูปภาพ

รีเทิร์น

String — URL ของรูปภาพ (หากมี) แสดงผล null หากรูปภาพไม่พร้อมใช้งานหรือไม่ มี URL แหล่งที่มา

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

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

  • 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 — ความกว้างของรูปภาพเป็นพิกเซล

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

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

  • 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();
}

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

สคริปต์ที่ใช้เมธอดนี้ต้องมีการให้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 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)

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

พารามิเตอร์

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

รีเทิร์น

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