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à duy nhất; nhiều dải ô khác nhau trong cùng một tài liệu 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 tài liệu, giống như mã nhận dạng trong HTML. Sau khi thêm NamedRange vào tài liệu, bạn chỉ có thể xoá mà không thể sửa đổi tài liệu đó.
Bất kỳ tập lệnh nào truy cập vào tài liệu này đều có thể truy cập NamedRange. Để tránh xung đột ngoài ý muốn giữa các tập lệnh, hãy cân nhắc thêm một chuỗi duy nhất vào trước tên dải ô.
// Create a named range that includes every table in the document.
var doc = DocumentApp.getActiveDocument();
var rangeBuilder = doc.newRange();
var tables = doc.getBody().getTables();
for (var i = 0; i < tables.length; i++) {
rangeBuilder.addElement(tables[i]);
}
doc.addNamedRange('myUniquePrefix-tables', rangeBuilder.build());
Phương thức
| Phương thức | Kiểu dữ liệu trả về | Mô tả ngắn |
|---|---|---|
getId() | String | Lấy mã nhận dạng của NamedRange này. |
getName() | String | Lấy tên của NamedRange này. |
getRange() | Range | Lấy phạm vi các phần tử liên kết với NamedRange này. |
remove() | void | Xoá NamedRange này khỏi tài liệu. |
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 tài liệu.
Cầu thủ trả bóng
String — mã nhận dạng của dải ô là mã duy nhất trong tài liệu
getName()
Lấy tên của NamedRange này. Tên không nhất thiết phải là tên 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
Tập lệnh sử dụng phương thức này cần đượ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 – 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 cần đượ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 tài liệu. 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 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 cần đượ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