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	แสดงชีตที่รูปภาพนี้ปรากฏ
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