Class NamedRange

NamedRange

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ó bí danh chuỗi được liên kết. Bạn có thể xem và chỉnh sửa các báo cáo này thông qua Giao diện người dùng của Trang tính trong mục Dữ liệu > Dải ô được đặt tên....

Phương thức

Phương thứcLoại dữ liệu trả vềMô tả ngắn
getName()StringLấy tên của dải ô được đặt tên này.
getRange()RangeLấy dải ô được tham chiếu bởi dải ô có tên này.
remove()voidXoá 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 yêu cầu ủy 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ên này.

Cầu thủ trả bóng

Range — dải ô trong bảng tính được 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 yêu cầu ủy 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 yêu cầu ủy 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");
}

Tham số

TênLoạiMô tả
nameStringTên mới của dải ô được đặt tên.

Cầu thủ trả bóng

NamedRange — dải ô có tên do lệnh gọi đặ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/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.

Tham số

TênLoạiMô tả
rangeRangeDải ô trong bảng tính sẽ 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 ô trong bảng tính được đặ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/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets