Class NamedRange

NamedRange

สร้าง เข้าถึง และแก้ไขช่วงที่ตั้งชื่อแล้วในสเปรดชีต ช่วงที่ตั้งชื่อแล้วคือช่วงที่มี นามแฝงสตริงที่เชื่อมโยง โดยจะดูและแก้ไขได้ผ่าน UI ของชีตในเมนูข้อมูล > ช่วงที่มีชื่อ...

เมธอด

วิธีการประเภทการแสดงผลรายละเอียดแบบย่อ
getName()Stringรับชื่อของช่วงที่ตั้งชื่อแล้วนี้
getRange()Rangeรับช่วงที่ช่วงที่ตั้งชื่อแล้วนี้อ้างอิง
remove()voidลบช่วงที่ตั้งชื่อแล้วนี้
setName(name)NamedRangeตั้งค่า/อัปเดตชื่อของช่วงที่ตั้งชื่อแล้ว
setRange(range)NamedRangeตั้งค่า/อัปเดตช่วงสำหรับช่วงที่ตั้งชื่อแล้วนี้

เอกสารโดยละเอียด

getName()

รับชื่อของช่วงที่ตั้งชื่อแล้วนี้

รีเทิร์น

String - ชื่อของช่วงที่ตั้งชื่อแล้วนี้

การให้สิทธิ์

สคริปต์ที่ใช้วิธีนี้ต้องมีการให้สิทธิ์ที่มีขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

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

getRange()

รับช่วงที่ช่วงที่ตั้งชื่อแล้วนี้อ้างอิง

รีเทิร์น

Range - ช่วงสเปรดชีตที่เชื่อมโยงกับช่วงที่ตั้งชื่อแล้วนี้

การให้สิทธิ์

สคริปต์ที่ใช้วิธีนี้ต้องมีการให้สิทธิ์ที่มีขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

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

remove()

ลบช่วงที่ตั้งชื่อแล้วนี้ 

// 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();
}

การให้สิทธิ์

สคริปต์ที่ใช้วิธีนี้ต้องมีการให้สิทธิ์ที่มีขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

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

setName(name)

ตั้งค่า/อัปเดตชื่อของช่วงที่ตั้งชื่อแล้ว 

// The code below updates the name for the first named range.
const namedRanges = SpreadsheetApp.getActiveSpreadsheet().getNamedRanges();
if (namedRanges.length > 1) {
  namedRanges[0].setName('UpdatedNamedRange');
}

พารามิเตอร์

ชื่อประเภทคำอธิบาย
nameStringชื่อใหม่ของช่วงที่ตั้งชื่อแล้ว

รีเทิร์น

NamedRange - ช่วงที่การเรียกใช้ตั้งชื่อ

การให้สิทธิ์

สคริปต์ที่ใช้วิธีนี้ต้องมีการให้สิทธิ์ที่มีขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

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

setRange(range)

ตั้งค่า/อัปเดตช่วงสำหรับช่วงที่ตั้งชื่อแล้วนี้

พารามิเตอร์

ชื่อประเภทคำอธิบาย
rangeRangeช่วงสเปรดชีตที่จะเชื่อมโยงกับช่วงที่ตั้งชื่อแล้วนี้

รีเทิร์น

NamedRange — ช่วงที่ตั้งชื่อแล้วซึ่งมีการตั้งค่าช่วงสเปรดชีต

การให้สิทธิ์

สคริปต์ที่ใช้วิธีนี้ต้องมีการให้สิทธิ์ที่มีขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

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