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ó 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ứ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 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

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ênLoạiNội dung mô 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 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ênLoạiNội dung mô tả
rangeRangeDả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