หน้านี้ได้รับการแปลโดย Cloud Translation API

Class CellImage

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

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

พร็อพเพอร์ตี้	Type	คำอธิบาย
`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 — ชื่อข้อความแสดงแทน

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

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 แหล่งที่มา

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

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

`toBuilder()`

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

รีเทิร์น

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