Class CellImage

CellImage

Đại diện cho một hình ảnh cần thêm vào ô. Để 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 SpreadsheetApp.newCellImage() và CellImageBuilder. 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ínhLoạiMô tả
valueTypeValueTypeMột trường được đặt thành ValueType.IMAGE, đại diện cho loại giá trị hình ảnh.

Phương thức

Phương thứcLoại dữ liệu trả vềMô tả ngắn
getAltTextDescription()StringTrả về nội dung mô tả văn bản thay thế cho hình ảnh này.
getAltTextTitle()StringTrả về tiêu đề văn bản thay thế cho hình ảnh này.
getContentUrl()StringTrả về URL do Google lưu trữ cho hình ảnh.
getUrl()StringLấy URL nguồn của hình ảnh; trả về null nếu không có URL.
toBuilder()CellImageBuilderTạo một trình tạo giúp biến hình ảnh thành loại giá trị hình ảnh để bạn có thể đặt hình ảnh đó vào một ô.

Tài liệu chi tiết

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

getContentUrl()

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.

Cầu thủ trả bóng

String – URL của hình ảnh do Google lưu trữ.

getUrl()

Lấy URL nguồn của hình ảnh; trả về null nếu không có URL. Nếu hình ảnh được chèn bằng URL thông qua API, thì phương thức này sẽ trả về URL được cung cấp trong quá trình chèn hình ảnh.

Cầu thủ trả bóng

String – URL của hình ảnh (nếu có); trả về null nếu không có hình ảnh hoặc không có URL nguồn.

Ủ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

toBuilder()

Tạo một trình tạo giúp biến hình ảnh thành loại giá trị hình ảnh để bạn có thể đặt hình ảnh đó vào một ô. Trước khi đặt hình ảnh vào một ô, bạn cần tạo hình ảnh đó dưới dạng loại giá trị hình ảnh. 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).

Cầu thủ trả bóng

CellImageBuilder – 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.