Class NamedRange

Dải ôđược đặt tên

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ó tên đại diện chuỗi liên kết. Bạn có thể xem và chỉnh sửa các dải ô được đặt tên thông qua giao diện người dùng của Trang tính trong trình đơn 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 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 yêu cầu đượ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 ô 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 yêu cầu đượ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.
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 yêu cầu đượ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.
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 được đặt bằng lệnh gọi

Ủy quyền

Các tập lệnh sử dụng phương thức này yêu cầu đượ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.

Tham số

TênLoạiMô tả
rangeRangeDải ô trong 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 ô trong bảng tính được đặt

Ủy quyền

Các tập lệnh sử dụng phương thức này yêu cầu đượ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