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ức | Loại 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 dải phần tử liên kết với NamedRange này. |
remove() | void | Xoá 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