Class CellImageBuilder

CellImageBuilder

Trình tạo cho CellImage. Trình tạo này tạo giá trị hình ảnh cần thiết để thêm hình ảnh vào một ô.

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
build()CellImageTạo kiểu giá trị hình ảnh cần thiết để thêm hình ảnh vào một ô.
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.
setAltTextDescription(description)CellImageĐặt nội dung mô tả văn bản thay thế cho hình ảnh này.
setAltTextTitle(title)CellImageĐặt tiêu đề văn bản thay thế cho hình ảnh này.
setSourceUrl(url)CellImageBuilderĐặt URL nguồn hình ảnh.
toBuilder()CellImageBuilderTạo trình tạo hình ảnh trong ô dựa trên các thuộc tính hình ảnh hiện tại.

Tài liệu chi tiết

build()

Tạo kiểu giá trị hình ảnh cần thiết để thêm hình ảnh vào một ô. Giá trị hình ảnh được tạo từ các thuộc tính hình ảnh được thêm vào trình tạo, chẳng hạn như URL nguồn.

Cầu thủ trả bóng

CellImage – Hình ảnh cần thêm vào mộ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

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:

  • 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

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:

  • 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ẻ bằng tài khoản của người yêu cầu, vì vậy, bất kỳ ai có URL đều có thể truy cập vào hình ảnh dưới dạng người yêu cầu ban đầu. Quyền truy cập vào hình ảnh có thể bị mất 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.


setAltTextDescription(description)

Đặt nội dung mô tả văn bản thay thế cho hình ảnh này.

Thông số

TênLoạiMô tả
descriptionStringNội dung mô tả văn bản thay thế mới cho hình ảnh.

Cầu thủ trả bóng

CellImage – Hình ảnh này, để tạo chuỗi.

Ủy quyền

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:

  • 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.

Thông số

TênLoạiMô tả
titleStringTiêu đề văn bản thay thế mới cho hình ảnh.

Cầu thủ trả bóng

CellImage – Hình ảnh này, để tạo chuỗi.

Ủy quyền

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:

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

setSourceUrl(url)

Đặt URL nguồn hình ảnh.

Thông số

TênLoạiMô tả
urlStringURL của hình ảnh.

Cầu thủ trả bóng

CellImageBuilder – Trình tạo này, để tạo chuỗi.


toBuilder()

Tạo trình tạo hình ảnh trong ô dựa trên các thuộc tính hình ảnh hiện tại. Sử dụng setSourceUrl(url) để đặt URL nguồn của hình ảnh mới. Sau đó, bạn có thể thêm hình ảnh đó 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 kiểu 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