แสดงภาพเพื่อเพิ่มในเซลล์ หากต้องการเพิ่มรูปภาพลงในเซลล์ คุณต้องสร้างค่ารูปภาพใหม่สําหรับรูปภาพโดยใช้ SpreadsheetApp.newCellImage()
และ CellImageBuilder
จากนั้นจึงใช้ Range.setValue(value)
หรือ Range.setValues(values)
เพื่อเพิ่มค่ารูปภาพในเซลล์
พร็อพเพอร์ตี้
พร็อพเพอร์ตี้ | ประเภท | คำอธิบาย |
---|---|---|
valueType | ValueType | ตั้งค่าช่องเป็น 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
— เครื่องมือสร้างประเภทค่ารูปภาพโดยอิงตามคุณสมบัติของรูปภาพนั้นๆ