Class NamedRange

Range ที่มีชื่อ

สร้าง เข้าถึง และแก้ไขช่วงที่ตั้งชื่อในสเปรดชีต ช่วงที่ตั้งชื่อแล้วคือช่วงที่มีอลิแอสสตริงที่เชื่อมโยง โดยดูและแก้ไขได้ผ่าน 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');
}

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
name	String	ชื่อใหม่ของช่วงที่มีชื่อ

รีเทิร์น

NamedRange — ช่วงที่ชื่อได้รับการตั้งค่าโดยการเรียกใช้

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

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

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

---

setRange(range)

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

พารามิเตอร์

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

รีเทิร์น

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

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

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

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