Class CellImage

CellImage

แสดงรูปภาพที่จะเพิ่มลงในเซลล์ หากต้องการเพิ่มรูปภาพลงในเซลล์ คุณต้องสร้างค่ารูปภาพใหม่สำหรับรูปภาพโดยใช้ SpreadsheetApp.newCellImage() และ CellImageBuilder จากนั้นคุณจะใช้ Range.setValue(value) หรือ Range.setValues(values) เพื่อเพิ่มค่ารูปภาพลงในเซลล์ได้

พร็อพเพอร์ตี้

พร็อพเพอร์ตี้Typeคำอธิบาย
valueTypeValueTypeตั้งค่าช่องเป็น ValueType.IMAGE ซึ่งแสดงประเภทค่าของรูปภาพ

วิธีการ

วิธีการประเภทการแสดงผลรายละเอียดแบบย่อ
getAltTextDescription()Stringแสดงคำอธิบายข้อความแสดงแทนสำหรับรูปภาพนี้
getAltTextTitle()Stringแสดงชื่อข้อความแสดงแทนสำหรับรูปภาพนี้
getContentUrl()Stringแสดงผล URL ที่โฮสต์โดย Google ไปยังรูปภาพ
getUrl()Stringรับ URL แหล่งที่มาของรูปภาพ และแสดงผล null หาก URL ไม่พร้อมใช้งาน
toBuilder()CellImageBuilderสร้างเครื่องมือสร้างที่เปลี่ยนรูปภาพเป็นประเภทค่าของรูปภาพเพื่อให้คุณวางรูปภาพลงในเซลล์ได้

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

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

getContentUrl()

แสดงผล URL ที่โฮสต์โดย Google ไปยังรูปภาพ URL นี้ติดแท็กด้วยบัญชีของผู้ขอ ดังนั้นทุกคนที่มี URL นี้จะเข้าถึงรูปภาพได้อย่างมีประสิทธิภาพในฐานะผู้ส่งคำขอต้นทาง คุณอาจไม่สามารถเข้าถึงรูปภาพได้หากมีการเปลี่ยนแปลงการตั้งค่าการแชร์ของสเปรดชีต URL ที่ส่งคืนจะหมดอายุ หลังจากผ่านไปไม่นาน

รีเทิร์น

String — URL ของรูปภาพที่โฮสต์โดย Google

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

toBuilder()

สร้างเครื่องมือสร้างที่เปลี่ยนรูปภาพเป็นประเภทค่าของรูปภาพเพื่อให้คุณวางรูปภาพลงในเซลล์ได้ ก่อนที่จะวางรูปภาพลงในเซลล์ คุณต้องสร้างรูปภาพเป็นประเภทค่าของรูปภาพ จากนั้นคุณจะเพิ่มลงในเซลล์ได้โดยใช้ Range.setValue(value) หรือ Range.setValues(values)

รีเทิร์น

CellImageBuilder — เครื่องมือสร้างที่สร้างประเภทค่าของรูปภาพตามคุณสมบัติของรูปภาพที่ระบุ