สร้าง เข้าถึง และแก้ไขช่วงที่ตั้งชื่อแล้วในสเปรดชีต ช่วงที่มีชื่อคือช่วงที่มี ชื่อแทนสตริงที่เกี่ยวข้อง คุณสามารถดูและแก้ไขผ่าน 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()
remove()
ลบช่วงที่ตั้งชื่อนี้
// 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(); }
การให้สิทธิ์
สคริปต์ที่ใช้เมธอดนี้ต้องมีการให้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 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. var 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