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

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

วิธีการ	ประเภทการแสดงผล	รายละเอียดแบบย่อ
getUrl()	String	รับ URL แหล่งที่มาของรูปภาพ

เอกสารโดยละเอียด

assignScript(functionName)

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

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
functionName	String	ชื่อของฟังก์ชันที่ระบุ ฟังก์ชันนี้ต้องเป็นฟังก์ชันระดับบนสุดแบบสาธารณะ ไม่ใช่ฟังก์ชันที่ลงท้ายด้วยขีดล่าง เช่น 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

พารามิเตอร์

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

รีเทิร์น

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

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

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

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

---

replace(url)

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

พารามิเตอร์

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

รีเทิร์น

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)

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

พารามิเตอร์

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

รีเทิร์น

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

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

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

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

---

setAltTextTitle(title)

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

พารามิเตอร์

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

รีเทิร์น

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

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

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

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

---

setAnchorCell(cell)

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

พารามิเตอร์

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

รีเทิร์น

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

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

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

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

---

setAnchorCellXOffset(offset)

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

พารามิเตอร์

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

รีเทิร์น

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

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

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

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

---

setAnchorCellYOffset(offset)

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

พารามิเตอร์

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

รีเทิร์น

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

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

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

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

---

setHeight(height)

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

พารามิเตอร์

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

รีเทิร์น

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

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

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

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

---

setWidth(width)

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

พารามิเตอร์

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

รีเทิร์น

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

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

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

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

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

getUrl()

เลิกใช้งานแล้ว สำหรับรูปภาพที่เพิ่งแทรกส่วนใหญ่ URL แหล่งที่มาจะไม่พร้อมใช้งาน

รับ URL แหล่งที่มาของรูปภาพ แสดงผลสตริงว่างหาก URL ไม่พร้อมใช้งาน สำหรับรูปภาพที่เพิ่งแทรกใหม่ส่วนใหญ่ URL แหล่งที่มาจะไม่พร้อมใช้งานไม่ว่าจะแทรกรูปภาพอย่างไรก็ตาม

รีเทิร์น

String — URL แหล่งที่มาของรูปภาพ (หากมี) หรือแสดงผลสตริงว่าง

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

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

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