แสดงรูปภาพในตารางกริดในสเปรดชีต
เมธอด
วิธีการ | ประเภทการแสดงผล | รายละเอียดแบบย่อ |
---|---|---|
assignScript(functionName) | OverGridImage | กำหนดฟังก์ชันด้วยชื่อฟังก์ชันที่ระบุให้กับอิมเมจนี้ |
getAltTextDescription() | String | แสดงคำอธิบายข้อความแสดงแทนสำหรับรูปภาพนี้ |
getAltTextTitle() | String | แสดงชื่อข้อความแสดงแทนสำหรับรูปภาพนี้ |
getAnchorCell() | Range | แสดงผลเซลล์ที่ตรึงรูปภาพไว้ |
getAnchorCellXOffset() | Integer | แสดงค่าออฟเซ็ตพิกเซลแนวนอนจาก Anchorเซลล์ |
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)
กำหนดฟังก์ชันด้วยชื่อฟังก์ชันที่ระบุให้กับอิมเมจนี้
พารามิเตอร์
ชื่อ | ประเภท | คำอธิบาย |
---|---|---|
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()
getAnchorCellXOffset()
แสดงค่าออฟเซ็ตพิกเซลแนวนอนจาก Anchorเซลล์
รีเทิร์น
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
พารามิเตอร์
ชื่อ | ประเภท | คำอธิบาย |
---|---|---|
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 | Anchorเซลล์ใหม่ |
รีเทิร์น
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