Class NamedRange

NamedRange

Range có tên và mã nhận dạng để cho phép truy xuất sau này. Tên không được chấp nhận nhất thiết phải là duy nhất; nhiều dải ô khác nhau trong cùng một thẻ có thể có cùng tên, giống như trong HTML. Ngược lại, 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 thêm NamedRange vào một thẻ, bạn không thể sửa đổi mà chỉ có thể xoá đi.

Bất kỳ tập lệnh nào truy cập vào thẻ đó đều có thể truy cập NamedRange. Để tránh trường hợp ngoài ý muốn xung đột giữa các tập lệnh, hãy xem xét việc thêm tiền tố vào 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.
var documentTab = DocumentApp.getActiveDocument().getActiveTab().asDocumentTab();
var rangeBuilder = documentTab.newRange();
var tables = documentTab.getBody().getTables();
for (var 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 dải 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 là duy nhất trong thẻ.

Cầu thủ trả bóng

String — Mã nhận dạng dải ô. Mã này là 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à duy nhất.

Ủy quyền

Tập lệnh sử dụng phương thức này yêu cầu ủy 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 dải phần tử liên kết với NamedRange này.

Cầu thủ trả bóng

Range — Dải ô các phần tử liên kết với tên và mã nhận dạng.

Ủy quyền

Tập lệnh sử dụng phương thức này yêu cầu ủy 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 dải ô; nó chỉ xoá tham chiếu. Gọi phương thức này trên NamedRange đã bị xoá không có hiệu lực.

Ủy quyền

Tập lệnh sử dụng phương thức này yêu cầu ủy 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