Tạo, truy cập và sửa đổi các dải ô được đặt tên trong bảng tính. Dải ô được đặt tên là các dải ô có các bí danh chuỗi được liên kết. Bạn có thể xem và chỉnh sửa các dải ô này thông qua giao diện người dùng Trang tính trong trình đơn Dữ liệu > Dải ô được đặt tên....
Phương thức
Phương thức | Kiểu dữ liệu trả về | Mô tả ngắn |
---|---|---|
getName() | String | Lấy tên của dải ô được đặt tên này. |
getRange() | Range | Lấy dải ô được tham chiếu bởi dải ô được đặt tên này. |
remove() | void | Xoá dải ô được đặt tên này. |
setName(name) | NamedRange | Đặt/cập nhật tên của dải ô được đặt tên. |
setRange(range) | NamedRange | Đặt/cập nhật dải ô cho dải ô được đặt tên này. |
Tài liệu chi tiết
getName()
Lấy tên của dải ô được đặt tên này.
Cầu thủ trả bóng
String
— tên của dải ô được đặt tên này
Ủ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/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getRange()
Lấy dải ô được tham chiếu bởi dải ô được đặt tên này.
Cầu thủ trả bóng
Range
— dải ô bảng tính liên kết với dải ô được đặt tên này
Ủ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/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
remove()
Xoá dải ô được đặt tên này.
// The code below deletes all the named ranges in the spreadsheet. var namedRanges = SpreadsheetApp.getActive().getNamedRanges(); for (var i = 0; i < namedRanges.length; i++) { namedRanges[i].remove(); }
Ủ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/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setName(name)
Đặt/cập nhật tên của dải ô được đặt tên.
// The code below updates the name for the first named range. var namedRanges = SpreadsheetApp.getActiveSpreadsheet().getNamedRanges(); if (namedRanges.length > 1) { namedRanges[0].setName("UpdatedNamedRange"); }
Các tham số
Tên | Loại | Nội dung mô tả |
---|---|---|
name | String | Tên mới của dải ô được đặt tên. |
Cầu thủ trả bóng
NamedRange
– dải ô có tên được đặt theo lệnh gọi
Ủ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/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setRange(range)
Đặt/cập nhật dải ô cho dải ô được đặt tên này.
Các tham số
Tên | Loại | Nội dung mô tả |
---|---|---|
range | Range | Dải ô bảng tính để liên kết với dải ô được đặt tên này. |
Cầu thủ trả bóng
NamedRange
— dải ô được đặt tên mà dải ô bảng tính được đặ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/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets