Đại diện cho giá trị hình ảnh trong một ô. Để thêm hình ảnh vào một ô, bạn phải tạo một giá trị hình ảnh mới cho hình ảnh đó bằng cách sử dụng Spreadsheet
và Cell
. Sau đó, bạn có thể sử dụng Range.setValue(value)
hoặc Range.setValues(values)
để thêm giá trị hình ảnh vào ô.
Thuộc tính
Thuộc tính | Loại | Mô tả |
---|---|---|
value | Value | Loại giá trị của hình ảnh ô là Value . |
Phương thức
Phương thức | Loại dữ liệu trả về | Mô tả ngắn |
---|---|---|
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 | String | Trả về URL do Google lưu trữ cho hình ảnh. |
to | Cell | Tạo trình tạo hình ảnh ô dựa trên các thuộc tính hình ảnh hiện tại. |
Tài liệu chi tiết
get Alt Text Description()
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
get Alt Text Title()
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
get Content Url()
Trả về URL do Google lưu trữ cho hình ảnh. URL này được gắn thẻ với tài khoản của người yêu cầu, vì vậy, bất kỳ ai có URL này đều có thể truy cập vào hình ảnh dưới vai trò là người yêu cầu ban đầu. Bạn có thể mất quyền truy cập vào hình ảnh nếu chế độ cài đặt chia sẻ của bảng tính thay đổi. URL được trả về sẽ hết hạn sau một khoảng thời gian ngắn.
const range = SpreadsheetApp.getActiveSpreadsheet().getRange("Sheet1!A1"); const value = range.getValue(); if (value.valueType == SpreadsheetApp.ValueType.IMAGE) { console.log(value.getContentUrl()); }
Cầu thủ trả bóng
String
– URL của hình ảnh do Google lưu trữ.
to Builder()
Tạo trình tạo hình ảnh ô dựa trên các thuộc tính hình ảnh hiện tại. Sử dụng Cell
để đặt URL nguồn của hình ảnh mới. Sau đó, bạn có thể thêm giá trị này vào một ô bằng cách sử dụng Range.setValue(value)
hoặc Range.setValues(values)
.
const ss = SpreadsheetApp.getActiveSpreadsheet(); const range = ss.getRange("Sheet1!A1"); const value = range.getValue(); if (value.valueType == SpreadsheetApp.ValueType.IMAGE) { const newImage = value.toBuilder() .setSourceUrl( 'https://www.gstatic.com/images/branding/productlogos/apps_script/v10/web-64dp/logo_apps_script_color_1x_web_64dp.png', ) .build(); const newRange = ss.getRange("Sheet1!A2"); newRange.setValue(newImage); }
Cầu thủ trả bóng
Cell
– Một trình tạo tạo loại giá trị hình ảnh dựa trên các thuộc tính hình ảnh đã cho.