Class NamedRange

NamedRange

Tạo, truy cập và sửa đổi dải ô được đặt tên trong bảng tính. Dải ô được đặt tên là những dải ô có bí danh chuỗi được liên kết. Bạn có thể xem và chỉnh sửa các phạm vi này thông qua giao diện người dùng của Trang tính trong trình đơn Dữ liệu > Phạm vi có tên....

Phương thức

Phương thứcKiểu 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 theo dải ô được đặt 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

Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

getRange()

Lấy dải ô được tham chiếu theo dải ô được đặt 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

Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

  • 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.
const namedRanges = SpreadsheetApp.getActive().getNamedRanges();
for (let i = 0; i < namedRanges.length; i++) {
  namedRanges[i].remove();
}

Ủy quyền

Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

  • 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.
const 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

Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

  • 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 cần 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 ô của bảng tính được đặt

Ủy quyền

Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets