Class CellImage

CellImage

Đạ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 SpreadsheetApp.newCellImage()CellImageBuilder. Sau đó, bạn có thể 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ả
valueTypeValueTypeLoại giá trị của hình ảnh trong ô là ValueType.IMAGE.

Phương thức

Phương thứcKiểu 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ề một URL do Google lưu trữ cho hình ảnh.
toBuilder()CellImageBuilderTạ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

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 cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

  • 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 cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

getContentUrl()

Trả về một URL do Google lưu trữ cho hình ảnh. URL này được gắn thẻ bằng 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 với tư cách 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 cài đặt cách 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 do Google lưu trữ của hình ảnh.


toBuilder()

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 CellImageBuilder.setSourceUrl(url) để đặt URL nguồn của hình ảnh mới. Sau đó, bạn có thể thêm đối tượng 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

CellImageBuilder – Trình tạo tạo ra một loại giá trị hình ảnh dựa trên các thuộc tính hình ảnh đã cho.

Các phương thức ngừng hoạt động