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

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

พารามิเตอร์

ชื่อ	Type	คำอธิบาย
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
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

พารามิเตอร์

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

รีเทิร์น

OverGridImage — รูปภาพนี้สำหรับการทำเชน

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

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

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

---

replace(url)

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

พารามิเตอร์

ชื่อ	Type	คำอธิบาย
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)

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

พารามิเตอร์

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

รีเทิร์น

OverGridImage — รูปภาพนี้สำหรับการทำเชน

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

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

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

---

setAltTextTitle(title)

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

พารามิเตอร์

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

รีเทิร์น

OverGridImage — รูปภาพนี้สำหรับการทำเชน

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

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

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

---

setAnchorCell(cell)

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

พารามิเตอร์

ชื่อ	Type	คำอธิบาย
cell	Range	เซลล์จุดยึดใหม่

รีเทิร์น

OverGridImage — รูปภาพนี้สำหรับการทำเชน

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

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

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

---

setAnchorCellXOffset(offset)

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

พารามิเตอร์

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

รีเทิร์น

OverGridImage — รูปภาพนี้สำหรับการทำเชน

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

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

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

---

setAnchorCellYOffset(offset)

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

พารามิเตอร์

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

รีเทิร์น

OverGridImage — รูปภาพนี้สำหรับการทำเชน

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

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

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

---

setHeight(height)

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

พารามิเตอร์

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

รีเทิร์น

OverGridImage — รูปภาพสำหรับเชน

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

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

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

---

setWidth(width)

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

พารามิเตอร์

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

รีเทิร์น

OverGridImage — รูปภาพสำหรับเชน

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

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

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