Class NamedRange

Dải ôđược đặt tên

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à duy nhất; một số dải ô khác nhau trong cùng một thẻ có thể có cùng tên, giống như một lớp trong HTML. Ngược lại, mã nhận dạng là duy nhất trong thẻ, giống như mã nhận dạng trong HTML. Sau khi thêm NamedRange vào một thẻ, bạn không thể sửa đổi mà chỉ có thể xoá thẻ đó.

Mọi tập lệnh truy cập vào thẻ đều có thể truy cập vào NamedRange. Để tránh các xung đột không mong muốn giữa các tập lệnh, hãy cân nhắc đặt 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ứcLoại 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ác phần tử 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 duy nhấ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à tên duy nhất.

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

getRange()

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

Cầu thủ trả bóng

Range – Phạm vi 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 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/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 phạm vi; mà chỉ xoá tệp tham chiếu. Việc gọi phương thức này trên một NamedRange đã bị xoá sẽ không có hiệu lự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/documents.currentonly
  • https://www.googleapis.com/auth/documents