Trang này được dịch bởi Cloud Translation API.

Class 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ính	Loại	Mô tả
`valueType`	`ValueType`	Loại giá trị của hình ảnh ô là `ValueType.IMAGE`.

Phương thức

Phương thức	Loại dữ liệu trả về	Mô tả ngắn
`build()`	`CellImage`	Tạo loại giá trị hình ảnh cần thiết để thêm hình ảnh vào một ô.
`getAltTextDescription()`	`String`	Trả về nội dung mô tả văn bản thay thế cho hình ảnh này.
`getAltTextTitle()`	`String`	Trả về tiêu đề văn bản thay thế cho hình ảnh này.
`getContentUrl()`	`String`	Trả 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()`	`CellImageBuilder`	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.

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
`getUrl()`	`String`	Lấy URL nguồn của hình ảnh.

Tài liệu chi tiết

`build()`

Tạo loại 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 – Biểu thị 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

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.

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

`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ả 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

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

CellImage – 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

`setSourceUrl(url)`

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

Tham số

Tên	Loại	Mô tả
`url`	`String`	URL 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 ô 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 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

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.

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

`getUrl()`

Không dùng nữa. Đối với hầu hết hình ảnh mới 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