Đại diện cho một hình ảnh trên lưới trong bảng tính.
Phương thức
Phương thức | Loại dữ liệu trả về | Mô tả ngắn |
---|---|---|
assign | Over | Chỉ định hàm có tên hàm được chỉ định cho hình ảnh này. |
get | String | Trả về nội dung mô tả văn bản thay thế cho hình ảnh này. |
get | String | Trả về tiêu đề văn bản thay thế cho hình ảnh này. |
get | Range | Trả về ô chứa hình ảnh được neo. |
get | Integer | Trả về độ dời theo chiều ngang của pixel từ ô neo. |
get | Integer | Trả về độ dời theo chiều dọc tính từ ô neo. |
get | Integer | Trả về chiều cao thực tế của hình ảnh này tính bằng pixel. |
get | Integer | Trả về chiều cao vốn có của hình ảnh này tính bằng pixel. |
get | Integer | Trả về chiều cao vốn có của hình ảnh này tính bằng pixel. |
get | String | Trả về tên của hàm được chỉ định cho hình ảnh này. |
get | Sheet | Trả về trang tính chứa hình ảnh này. |
get | Integer | Trả về chiều rộng thực tế của hình ảnh này tính bằng pixel. |
remove() | void | Xoá hình ảnh này khỏi bảng tính. |
replace(blob) | Over | Thay thế hình ảnh này bằng hình ảnh do Blob được cung cấp chỉ định. |
replace(url) | Over | Thay thế hình ảnh này bằng hình ảnh từ URL đã chỉ định. |
reset | Over | Đặt lại hình ảnh này về kích thước vốn có. |
set | Over | Đặt nội dung mô tả văn bản thay thế cho hình ảnh này. |
set | Over | Đặt tiêu đề văn bản thay thế cho hình ảnh này. |
set | Over | Đặt ô nơi neo hình ảnh. |
set | Over | Đặt độ dời pixel theo chiều ngang từ ô neo. |
set | Over | Đặt độ dời pixel theo chiều dọc từ ô neo. |
set | Over | Đặt chiều cao thực tế của hình ảnh này tính bằng pixel. |
set | Over | Đặt chiều rộng thực tế của hình ảnh này tính bằng pixel. |
Các phương thức ngừng hoạt động
Phương thức | Loại dữ liệu trả về | Mô tả ngắn |
---|---|---|
| String | Lấy URL nguồn của hình ảnh. |
Tài liệu chi tiết
assignScript(functionName)
Chỉ định hàm có tên hàm được chỉ định cho hình ảnh này.
Tham số
Tên | Loại | Mô tả |
---|---|---|
function | String | Tên của hàm đang được chỉ định. Đây phải là hàm cấp cao nhất công khai, chứ không phải hàm có dấu gạch dưới ở cuối như private . |
Cầu thủ trả bóng
Over
– Hình ảnh này, để tạo chuỗi.
Ủy quyền
Các tập lệnh sử dụng phương thức này yêu cầu được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getAltTextDescription()
Trả về nội dung mô tả văn bản thay thế cho hình ảnh này.
Cầu thủ trả bóng
String
– Nội dung mô tả văn bản thay thế.
Ủy quyền
Các tập lệnh sử dụng phương thức này yêu cầu được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getAltTextTitle()
Trả về tiêu đề văn bản thay thế cho hình ảnh này.
Cầu thủ trả bóng
String
– Tiêu đề văn bản thay thế.
Ủy quyền
Các tập lệnh sử dụng phương thức này yêu cầu được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getAnchorCell()
getAnchorCellXOffset()
Trả về độ dời theo chiều ngang của pixel từ ô neo.
Cầu thủ trả bóng
Integer
– Độ lệch pixel theo chiều ngang.
Ủy quyền
Các tập lệnh sử dụng phương thức này yêu cầu được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getAnchorCellYOffset()
Trả về độ dời theo chiều dọc tính từ ô neo.
Cầu thủ trả bóng
Integer
– Độ lệch pixel theo chiều dọc.
Ủy quyền
Các tập lệnh sử dụng phương thức này yêu cầu được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getHeight()
Trả về chiều cao thực tế của hình ảnh này tính bằng pixel.
// Logs the height of all images in a spreadsheet const images = SpreadsheetApp.getActiveSpreadsheet().getImages(); for (let i = 0; i < images.length; i++) { Logger.log(images[i].getHeight()); }
Cầu thủ trả bóng
Integer
– Chiều cao của hình ảnh tính bằng pixel.
Ủy quyền
Các tập lệnh sử dụng phương thức này yêu cầu được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getInherentHeight()
Trả về chiều cao vốn có của hình ảnh này tính bằng pixel.
Cầu thủ trả bóng
Integer
– Chiều cao vốn có tính bằng pixel.
Ủy quyền
Các tập lệnh sử dụng phương thức này yêu cầu được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getInherentWidth()
Trả về chiều cao vốn có của hình ảnh này tính bằng pixel.
Cầu thủ trả bóng
Integer
– Chiều rộng vốn có tính bằng pixel.
Ủy quyền
Các tập lệnh sử dụng phương thức này yêu cầu được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getScript()
Trả về tên của hàm được chỉ định cho hình ảnh này.
Cầu thủ trả bóng
String
– Tên của hàm.
Ủy quyền
Các tập lệnh sử dụng phương thức này yêu cầu được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getSheet()
Trả về trang tính chứa hình ảnh này.
// Logs the parent sheet of all images in a spreadsheet const images = SpreadsheetApp.getActiveSpreadsheet().getImages(); for (let i = 0; i < images.length; i++) { Logger.log(images[i].getSheet()); }
Cầu thủ trả bóng
Sheet
– Trang tính chứa hình ảnh.
Ủy quyền
Các tập lệnh sử dụng phương thức này yêu cầu được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getWidth()
Trả về chiều rộng thực tế của hình ảnh này tính bằng pixel.
// Logs the width of all images in a spreadsheet const images = SpreadsheetApp.getActiveSpreadsheet().getImages(); for (let i = 0; i < images.length; i++) { Logger.log(images[i].getWidth()); }
Cầu thủ trả bóng
Integer
– Chiều rộng của hình ảnh tính bằng pixel.
Ủy quyền
Các tập lệnh sử dụng phương thức này yêu cầu được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
remove()
Xoá hình ảnh này khỏi bảng tính. Mọi thao tác khác trên hình ảnh sẽ dẫn đến lỗi tập lệnh.
// Deletes all images in a spreadsheet const images = SpreadsheetApp.getActiveSpreadsheet().getImages(); for (let i = 0; i < images.length; i++) { images[i].remove(); }
Ủy quyền
Các tập lệnh sử dụng phương thức này yêu cầu được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
replace(blob)
Thay thế hình ảnh này bằng hình ảnh do Blob
được cung cấp chỉ định. Kích thước tối đa của blob được hỗ trợ là 2 MB.
Tham số
Tên | Loại | Mô tả |
---|---|---|
blob | Blob | Hình ảnh mới dưới dạng Blob. |
Cầu thủ trả bóng
Over
– Hình ảnh này, để tạo chuỗi.
Ủy quyền
Các tập lệnh sử dụng phương thức này yêu cầu được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
replace(url)
Thay thế hình ảnh này bằng hình ảnh từ URL đã chỉ định.
Tham số
Tên | Loại | Mô tả |
---|---|---|
url | String | URL của hình ảnh mới. |
Cầu thủ trả bóng
Over
– Hình ảnh này, để tạo chuỗi.
Ủy quyền
Các tập lệnh sử dụng phương thức này yêu cầu được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
resetSize()
Đặt lại hình ảnh này về kích thước vốn có.
Cầu thủ trả bóng
Over
– Hình ảnh này, để tạo chuỗi.
Ủy quyền
Các tập lệnh sử dụng phương thức này yêu cầu được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setAltTextDescription(description)
Đặt nội dung mô tả văn bản thay thế cho hình ảnh này.
Tham số
Tên | Loại | Mô tả |
---|---|---|
description | String | Nội dung mô tả mới của văn bản thay thế cho hình ảnh. |
Cầu thủ trả bóng
Over
– Hình ảnh này, để tạo chuỗi.
Ủy quyền
Các tập lệnh sử dụng phương thức này yêu cầu được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setAltTextTitle(title)
Đặt tiêu đề văn bản thay thế cho hình ảnh này.
Tham số
Tên | Loại | Mô tả |
---|---|---|
title | String | Tiêu đề văn bản thay thế mới cho hình ảnh. |
Cầu thủ trả bóng
Over
– Hình ảnh này, để tạo chuỗi.
Ủy quyền
Các tập lệnh sử dụng phương thức này yêu cầu được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setAnchorCell(cell)
Đặt ô nơi neo hình ảnh.
Tham số
Tên | Loại | Mô tả |
---|---|---|
cell | Range | Ô neo mới. |
Cầu thủ trả bóng
Over
– Hình ảnh này, để tạo chuỗi.
Ủy quyền
Các tập lệnh sử dụng phương thức này yêu cầu được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setAnchorCellXOffset(offset)
Đặt độ dời pixel theo chiều ngang từ ô neo.
Tham số
Tên | Loại | Mô tả |
---|---|---|
offset | Integer | Độ lệch pixel theo chiều ngang mới. |
Cầu thủ trả bóng
Over
– Hình ảnh này, để tạo chuỗi.
Ủy quyền
Các tập lệnh sử dụng phương thức này yêu cầu được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setAnchorCellYOffset(offset)
Đặt độ dời pixel theo chiều dọc từ ô neo.
Tham số
Tên | Loại | Mô tả |
---|---|---|
offset | Integer | Độ lệch pixel dọc mới. |
Cầu thủ trả bóng
Over
– Hình ảnh này, để tạo chuỗi.
Ủy quyền
Các tập lệnh sử dụng phương thức này yêu cầu được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setHeight(height)
Đặt chiều cao thực tế của hình ảnh này tính bằng pixel.
Tham số
Tên | Loại | Mô tả |
---|---|---|
height | Integer | Chiều cao mong muốn tính bằng pixel. |
Cầu thủ trả bóng
Over
– Hình ảnh để tạo chuỗi.
Ủy quyền
Các tập lệnh sử dụng phương thức này yêu cầu được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setWidth(width)
Đặt chiều rộng thực tế của hình ảnh này tính bằng pixel.
Tham số
Tên | Loại | Mô tả |
---|---|---|
width | Integer | Chiều rộng mong muốn tính bằng pixel. |
Cầu thủ trả bóng
Over
– Hình ảnh để tạo chuỗi.
Ủy quyền
Các tập lệnh sử dụng phương thức này yêu cầu được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
Các phương thức ngừng hoạt động
getUrl()
getUrl()
Không dùng nữa. Đối với hầu hết hình ảnh mới được chèn, URL nguồn không có sẵn.
Lấy URL nguồn của hình ảnh. Trả về một chuỗi trống nếu không có URL. Đối với hầu hết hình ảnh mới được chèn, URL nguồn sẽ không có sẵn bất kể hình ảnh được chèn theo cách nào.
Cầu thủ trả bóng
String
– URL nguồn của hình ảnh (nếu có); trả về một chuỗi trống nếu không có.
Ủy quyền
Các tập lệnh sử dụng phương thức này yêu cầu được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets