แสดงรูปภาพในตารางกริดในสเปรดชีต
วิธีการ
วิธีการ | ประเภทการแสดงผล | รายละเอียดแบบย่อ |
---|---|---|
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()
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