Class NamedRange

NamedRange

Một Range có tên và mã nhận dạng để cho phép truy xuất sau này. Tên không nhất thiết phải là tên riêng biệt; một số dải ô khác nhau trong cùng một thẻ có thể dùng chung một tên, giống như một lớp trong HTML. Ngược lại, các mã nhận dạng là duy nhất trong thẻ, chẳng hạn như mã nhận dạng trong HTML. Sau khi được thêm vào một thẻ, NamedRange sẽ không thể sửa đổi mà chỉ có thể xoá.

Mọi tập lệnh truy cập vào thẻ đều có thể truy cập vào NamedRange. Để tránh xung đột không mong muốn giữa các tập lệnh, hãy cân nhắc việc thêm tiền tố cho tên dải ô bằng một chuỗi duy nhất. 

// Create a named range that includes every table in the active tab.
const documentTab =
    DocumentApp.getActiveDocument().getActiveTab().asDocumentTab();
const rangeBuilder = documentTab.newRange();
const tables = documentTab.getBody().getTables();
for (let i = 0; i < tables.length; i++) {
  rangeBuilder.addElement(tables[i]);
}
documentTab.addNamedRange('myUniquePrefix-tables', rangeBuilder.build());

Phương thức

Phương thứcKiểu dữ liệu trả vềMô tả ngắn
getId()StringLấy mã nhận dạng của NamedRange này.
getName()StringLấy tên của NamedRange này.
getRange()RangeLấy phạm vi của các phần tử được liên kết với NamedRange này.
remove()voidXoá NamedRange này khỏi thẻ.

Tài liệu chi tiết

getId()

Lấy mã nhận dạng của NamedRange này. Mã nhận dạng này là duy nhất trong thẻ.

Cầu thủ trả bóng

String – Mã nhận dạng của dải ô, là mã nhận dạng riêng biệt trong thẻ.

getName()

Lấy tên của NamedRange này. Tên không nhất thiết phải là duy nhất.

Cầu thủ trả bóng

String – Tên của dải ô, không nhất thiết phải là duy nhất.

Ủ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/documents.currentonly
  • https://www.googleapis.com/auth/documents

getRange()

Lấy phạm vi của các phần tử được liên kết với NamedRange này.

Cầu thủ trả bóng

Range – Phạm vi của các phần tử được liên kết với tên và mã nhận dạng.

Ủ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/documents.currentonly
  • https://www.googleapis.com/auth/documents

remove()

Xoá NamedRange này khỏi thẻ. Phương thức này không xoá nội dung của dải ô mà chỉ xoá tham chiếu. Việc gọi phương thức này trên một NamedRange đã bị xoá sẽ không có tác dụng.

Ủ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/documents.currentonly
  • https://www.googleapis.com/auth/documents