Class RangeList

RangeList

คอลเล็กชันอินสแตนซ์ Range อย่างน้อย 1 รายการในชีตเดียวกัน คุณสามารถใช้คลาสนี้เพื่อดำเนินการกับคอลเล็กชันของช่วงหรือเซลล์ที่ไม่อยู่ติดกัน

เมธอด

วิธีการ	ประเภทการแสดงผล	รายละเอียดแบบย่อ
activate()	RangeList	เลือกรายการอินสแตนซ์ Range
breakApart()	RangeList	แยกเซลล์ที่ผสานในแนวนอนหรือแนวตั้งทั้งหมดที่อยู่ในรายการช่วงออกเป็นเซลล์เดี่ยวอีกครั้ง
check()	RangeList	เปลี่ยนสถานะของช่องทําเครื่องหมายในช่วงเป็น "เลือกแล้ว"
clear()	RangeList	ล้างช่วงของเนื้อหา รูปแบบ และกฎการตรวจสอบข้อมูลสําหรับ Range แต่ละรายการในรายการช่วง
clear(options)	RangeList	ล้างช่วงของเนื้อหา รูปแบบ กฎการตรวจสอบข้อมูล และความคิดเห็นตามที่ระบุด้วยตัวเลือกที่ระบุ
clearContent()	RangeList	ล้างเนื้อหาของ Range แต่ละรายการในรายการช่วงโดยคงการจัดรูปแบบไว้
clearDataValidations()	RangeList	ล้างกฎการตรวจสอบข้อมูลสำหรับ Range แต่ละรายการในรายการช่วง
clearFormat()	RangeList	ล้างการจัดรูปแบบข้อความสำหรับ Range แต่ละรายการในรายการช่วง
clearNote()	RangeList	ล้างโน้ตสำหรับ Range แต่ละรายการในรายการช่วง
getRanges()	Range[]	แสดงรายการอินสแตนซ์ Range อย่างน้อย 1 รายการในชีตเดียวกัน
insertCheckboxes()	RangeList	แทรกช่องทำเครื่องหมายลงในเซลล์แต่ละเซลล์ในช่วงที่กำหนดค่าด้วย true สำหรับเลือก และ false สำหรับไม่ได้เลือก
insertCheckboxes(checkedValue)	RangeList	แทรกช่องทำเครื่องหมายลงในเซลล์แต่ละเซลล์ในช่วงที่กำหนดค่าด้วยค่าที่กำหนดเองสำหรับช่องที่เลือก และสตริงว่างสำหรับช่องที่ไม่ได้เลือก
insertCheckboxes(checkedValue, uncheckedValue)	RangeList	แทรกช่องทำเครื่องหมายลงในเซลล์แต่ละเซลล์ในช่วงที่กำหนดค่าด้วยค่าที่กำหนดเองสำหรับสถานะที่เลือกและไม่ได้เลือก
removeCheckboxes()	RangeList	นำช่องทำเครื่องหมายทั้งหมดออกจากช่วง
setBackground(color)	RangeList	กำหนดสีพื้นหลังสำหรับ Range แต่ละรายการในรายการช่วง
setBackgroundRGB(red, green, blue)	RangeList	ตั้งค่าพื้นหลังเป็นสี RGB ที่ระบุ
setBorder(top, left, bottom, right, vertical, horizontal)	RangeList	ตั้งค่าพร็อพเพอร์ตี้เส้นขอบสำหรับ Range แต่ละรายการในรายการช่วง
setBorder(top, left, bottom, right, vertical, horizontal, color, style)	RangeList	ตั้งค่าพร็อพเพอร์ตี้เส้นขอบด้วยสีและ/หรือสไตล์สำหรับ Range แต่ละรายการในรายการช่วง
setFontColor(color)	RangeList	กำหนดสีแบบอักษรให้กับ Range แต่ละรายการในรายการช่วง
setFontFamily(fontFamily)	RangeList	ตั้งค่าชุดแบบอักษรสำหรับ Range แต่ละรายการในรายการช่วง
setFontLine(fontLine)	RangeList	กำหนดรูปแบบบรรทัดแบบอักษรสำหรับ Range แต่ละรายการในรายการช่วง
setFontSize(size)	RangeList	กำหนดขนาดแบบอักษร (เป็นจุด) สำหรับ Range แต่ละรายการในรายการช่วง
setFontStyle(fontStyle)	RangeList	กำหนดสไตล์แบบอักษรสำหรับ Range แต่ละรายการในรายการช่วง
setFontWeight(fontWeight)	RangeList	กำหนดน้ำหนักแบบอักษรสำหรับ Range แต่ละรายการในรายการช่วง
setFormula(formula)	RangeList	อัปเดตสูตรสำหรับ Range แต่ละรายการในรายการช่วง
setFormulaR1C1(formula)	RangeList	อัปเดตสูตรสำหรับ Range แต่ละรายการในรายการช่วง
setHorizontalAlignment(alignment)	RangeList	ตั้งค่าการจัดแนวนอนสำหรับ Range แต่ละรายการในรายการช่วง
setNote(note)	RangeList	ตั้งค่าข้อความหมายเหตุสำหรับ Range แต่ละรายการในรายการช่วง
setNumberFormat(numberFormat)	RangeList	กำหนดรูปแบบตัวเลขหรือวันที่สำหรับ Range แต่ละรายการในรายการช่วง
setShowHyperlink(showHyperlink)	RangeList	ตั้งค่าว่าแต่ละ Range ในรายการช่วงควรแสดงไฮเปอร์ลิงก์หรือไม่
setTextDirection(direction)	RangeList	กำหนดทิศทางข้อความสำหรับเซลล์ในแต่ละ Range ในรายการช่วง
setTextRotation(degrees)	RangeList	ตั้งค่าการหมุนข้อความสำหรับเซลล์ในแต่ละ Range ในรายการช่วง
setValue(value)	RangeList	ตั้งค่าสำหรับ Range แต่ละรายการในรายการช่วง
setVerticalAlignment(alignment)	RangeList	ตั้งค่าการจัดแนวตั้งสำหรับ Range แต่ละรายการในรายการช่วง
setVerticalText(isVertical)	RangeList	ตั้งค่าว่าจะซ้อนข้อความสำหรับเซลล์ของ Range แต่ละรายการในรายการช่วงหรือไม่
setWrap(isWrapEnabled)	RangeList	ตั้งค่าการขึ้นบรรทัดใหม่ของข้อความสำหรับ Range แต่ละรายการในรายการช่วง
setWrapStrategy(strategy)	RangeList	ตั้งค่ากลยุทธ์การตัดข้อความสำหรับ Range แต่ละรายการในรายการช่วง
trimWhitespace()	RangeList	ตัดช่องว่าง (เช่น เว้นวรรค แท็บ หรือบรรทัดใหม่) ในทุกเซลล์ในรายการช่วงนี้
uncheck()	RangeList	เปลี่ยนสถานะของช่องทําเครื่องหมายในช่วงเป็น "ไม่ได้เลือก"

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

activate()

เลือกรายการอินสแตนซ์ Range ช่วงสุดท้ายในรายการจะตั้งค่าเป็น active range

หมายเหตุ: วิธีนี้เป็นวิธีเลือกช่วงหลายช่วง

const sheet = SpreadsheetApp.getActiveSheet();
const rangeList = sheet.getRangeList(['D4', 'B2:C4']);
rangeList.activate();

const selection = sheet.getSelection();
// Current cell: B2
const currentCell = selection.getCurrentCell();
// Active range: B2:C4
const activeRange = selection.getActiveRange();
// Active range list: [D4, B2:C4]
const activeRangeList = selection.getActiveRangeList();

รีเทิร์น

RangeList — รายการช่วงที่มีการใช้งานสําหรับการต่อเชื่อม

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

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

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

---

breakApart()

แยกเซลล์ที่ผสานในแนวนอนหรือแนวตั้งทั้งหมดที่อยู่ในรายการช่วงออกเป็นเซลล์เดี่ยวอีกครั้ง

การเรียกใช้ฟังก์ชันนี้ในรายการช่วงจะเหมือนกับการเลือกชุดของช่วงแล้วเลือกรายการเมนูชีตรูปแบบ > ผสาน > เลิกผสาน

const sheet = SpreadsheetApp.getActiveSheet();
const rangeList = sheet.getRangeList(['A:A', 'C:C']);
rangeList.breakApart();

รีเทิร์น

RangeList — รายการช่วงนี้สําหรับการต่อเชื่อม

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

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

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

---

check()

เปลี่ยนสถานะของช่องทําเครื่องหมายในช่วงเป็น "เลือกแล้ว" จะไม่สนใจเซลล์ในช่วงซึ่งปัจจุบันไม่ได้กําหนดค่าค่าที่เลือกหรือไม่ได้เลือกไว้

// Changes the state of cells which currently contain either the checked or
// unchecked value configured in the ranges D4 and E6 to 'checked'.
const rangeList = SpreadsheetApp.getActive().getRangeList(['D4', 'E6']);
rangeList.check();

รีเทิร์น

RangeList — รายการช่วงนี้สําหรับการต่อเชื่อม

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

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

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

---

clear()

ล้างช่วงของเนื้อหา รูปแบบ และกฎการตรวจสอบข้อมูลสําหรับ Range แต่ละรายการในรายการช่วง

const sheet = SpreadsheetApp.getActiveSheet();
const rangeList = sheet.getRangeList(['A:A', 'C:C']);
rangeList.clear();

รีเทิร์น

RangeList — รายการช่วงนี้สําหรับการต่อเชื่อม

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

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

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

---

clear(options)

ล้างช่วงของเนื้อหา รูปแบบ กฎการตรวจสอบข้อมูล และความคิดเห็นตามที่ระบุด้วยตัวเลือกที่ระบุ ระบบจะล้างข้อมูลทั้งหมดโดยค่าเริ่มต้น

// The code below clears the contents of the following ranges A:A and C:C in the
// active sheet, but preserves the format, data validation rules, and comments.
const sheet = SpreadsheetApp.getActiveSheet();
const rangeList = sheet.getRangeList(['A:A', 'C:C']);
rangeList.clear({contentsOnly: true});

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
options	Object	ออบเจ็กต์ JavaScript ที่ระบุพารามิเตอร์ขั้นสูงตามที่ระบุไว้ด้านล่าง

พารามิเตอร์ขั้นสูง

ชื่อ	ประเภท	คำอธิบาย
commentsOnly	Boolean	ล้างเฉพาะความคิดเห็นหรือไม่
contentsOnly	Boolean	ล้างเฉพาะเนื้อหาหรือไม่
formatOnly	Boolean	ล้างเฉพาะการจัดรูปแบบหรือไม่ โปรดทราบว่าการล้างการจัดรูปแบบจะเป็นการล้างกฎการตรวจสอบข้อมูลด้วย
validationsOnly	Boolean	ล้างเฉพาะกฎการตรวจสอบข้อมูลหรือไม่
skipFilteredRows	Boolean	กำหนดว่าจะหลีกเลี่ยงการล้างแถวที่กรองหรือไม่

รีเทิร์น

RangeList — รายการช่วงนี้สําหรับการต่อเชื่อม

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

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

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

---

clearContent()

ล้างเนื้อหาของ Range แต่ละรายการในรายการช่วงโดยคงการจัดรูปแบบไว้

const sheet = SpreadsheetApp.getActiveSheet();
const rangeList = sheet.getRangeList(['A:A', 'C:C']);
rangeList.clearContent();

รีเทิร์น

RangeList — รายการช่วงนี้สําหรับการต่อเชื่อม

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

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

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

---

clearDataValidations()

ล้างกฎการตรวจสอบข้อมูลสำหรับ Range แต่ละรายการในรายการช่วง

const sheet = SpreadsheetApp.getActiveSheet();
const rangeList = sheet.getRangeList(['A:A', 'C:C']);
rangeList.clearDataValidations();

รีเทิร์น

RangeList — รายการช่วงนี้สําหรับการต่อเชื่อม

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

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

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

---

clearFormat()

ล้างการจัดรูปแบบข้อความสำหรับ Range แต่ละรายการในรายการช่วง

ซึ่งจะเป็นการล้างการจัดรูปแบบข้อความสำหรับแต่ละช่วง แต่จะไม่รีเซ็ตกฎการจัดรูปแบบตัวเลข

const sheet = SpreadsheetApp.getActiveSheet();
const rangeList = sheet.getRangeList(['A:A', 'C:C']);
rangeList.clearFormat();

รีเทิร์น

RangeList — รายการช่วงนี้สําหรับการต่อเชื่อม

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

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

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

---

clearNote()

ล้างโน้ตสำหรับ Range แต่ละรายการในรายการช่วง

const sheet = SpreadsheetApp.getActiveSheet();
const rangeList = sheet.getRangeList(['A:A', 'C:C']);
rangeList.clearNote();

รีเทิร์น

RangeList — รายการช่วงนี้สําหรับการต่อเชื่อม

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

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

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

---

getRanges()

แสดงรายการอินสแตนซ์ Range อย่างน้อย 1 รายการในชีตเดียวกัน

รีเทิร์น

Range[] — รายการช่วง

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

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

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

---

insertCheckboxes()

แทรกช่องทำเครื่องหมายลงในเซลล์แต่ละเซลล์ในช่วงที่กำหนดค่าด้วย true สำหรับเลือก และ false สำหรับไม่ได้เลือก ตั้งค่าของเซลล์ทั้งหมดในช่วงเป็น false

const rangeList = SpreadsheetApp.getActive().getRangeList(['D4', 'E6']);

// Inserts checkboxes into each cell in the ranges D4 and E6 configured with
// 'true' for checked and 'false' for unchecked. Also, sets the value of each
// cell in the ranges D4 and E6 to 'false'.
rangeList.insertCheckboxes();

รีเทิร์น

RangeList — รายการช่วงนี้สําหรับการต่อเชื่อม

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

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

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

---

insertCheckboxes(checkedValue)

แทรกช่องทำเครื่องหมายลงในเซลล์แต่ละเซลล์ในช่วงที่กำหนดค่าด้วยค่าที่กำหนดเองสำหรับช่องที่เลือก และสตริงว่างสำหรับช่องที่ไม่ได้เลือก ตั้งค่าของเซลล์แต่ละเซลล์ในช่วงเป็นสตริงว่าง

const rangeList = SpreadsheetApp.getActive().getRangeList(['D4', 'E6']);

// Inserts checkboxes into each cell in the ranges D4 and E6 configured with
// 'yes' for checked and the empty string for unchecked. Also, sets the value of
// each cell in the ranges D4 and E6 to the empty string.
rangeList.insertCheckboxes('yes');

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
checkedValue	Object	ค่าที่เลือกสำหรับการตรวจสอบข้อมูลช่องทำเครื่องหมาย

รีเทิร์น

RangeList — รายการช่วงนี้สําหรับการต่อเชื่อม

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

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

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

---

insertCheckboxes(checkedValue, uncheckedValue)

แทรกช่องทำเครื่องหมายลงในเซลล์แต่ละเซลล์ในช่วงที่กำหนดค่าด้วยค่าที่กำหนดเองสำหรับสถานะที่เลือกและไม่ได้เลือก ตั้งค่าของเซลล์แต่ละเซลล์ในช่วงเป็นค่าที่กำหนดเองซึ่งไม่ได้เลือก

const rangeList = SpreadsheetApp.getActive().getRangeList(['D4', 'E6']);

// Inserts checkboxes into each cell in the ranges D4 and E6 configured with
// 'yes' for checked and 'no' for unchecked. Also, sets the value of each cell
// in the ranges D4 and E6 to 'no'.
rangeList.insertCheckboxes('yes', 'no');

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
checkedValue	Object	ค่าที่เลือกสำหรับการตรวจสอบข้อมูลช่องทำเครื่องหมาย
uncheckedValue	Object	ค่าที่ยกเลิกการเลือกสำหรับการตรวจสอบความถูกต้องของข้อมูลช่องทำเครื่องหมาย

รีเทิร์น

RangeList — รายการช่วงนี้สําหรับการต่อเชื่อม

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

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

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

---

removeCheckboxes()

นำช่องทำเครื่องหมายทั้งหมดออกจากช่วง ล้างการตรวจสอบข้อมูลของเซลล์แต่ละเซลล์ และล้างค่าของเซลล์ด้วยหากเซลล์มีค่าที่เลือกหรือไม่ได้เลือกไว้

const range = SpreadsheetApp.getActive().getRange('A1:B10');

// Inserts checkboxes and sets each cell value to 'no' in the range A1:B10.
range.insertCheckboxes('yes', 'no');

const rangeList1 = SpreadsheetApp.getActive().getRangeList(['A1', 'A3']);
rangeList1.setValue('yes');
// Removes the checkbox data validation in cells A1 and A3 and clears their
// value.
rangeList1.removeCheckboxes();

const rangeList2 = SpreadsheetApp.getActive().getRangeList(['A5', 'A7']);
rangeList2.setValue('random');
// Removes the checkbox data validation in cells A5 and A7 but does not clear
// their value.
rangeList2.removeCheckboxes();

รีเทิร์น

RangeList — รายการช่วงนี้สําหรับการต่อเชื่อม

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

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

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

---

setBackground(color)

กำหนดสีพื้นหลังสำหรับ Range แต่ละรายการในรายการช่วง สีจะแสดงในรูปแบบการเขียน CSS เช่น '#ffffff' หรือ 'white'

const sheet = SpreadsheetApp.getActiveSheet();
const rangeList = sheet.getRangeList(['A:A', 'C:C']);
rangeList.setBackground('red');

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
color	String	รหัสสีพื้นหลังในเครื่องหมาย CSS เช่น '#ffffff' หรือ 'white' ค่า null จะรีเซ็ตสี

รีเทิร์น

RangeList — รายการช่วงนี้สําหรับการต่อเชื่อม

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

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

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

---

setBackgroundRGB(red, green, blue)

ตั้งค่าพื้นหลังเป็นสี RGB ที่ระบุ นี่เป็น Wrapper ที่สะดวกสําหรับการเรียกใช้ setBackground(color)

const sheet = SpreadsheetApp.getActiveSheet();
const rangeList = sheet.getRangeList(['A:A', 'C:C']);
// Sets the background to red for each range in the range list.
rangeList.setBackgroundRGB(255, 0, 0);

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
red	Integer	ค่าสีแดงในรูปแบบ RGB
green	Integer	ค่าสีเขียวในรูปแบบ RGB
blue	Integer	ค่าสีน้ำเงินในรูปแบบ RGB

รีเทิร์น

RangeList — รายการช่วงนี้สําหรับการต่อเชื่อม

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

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

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

---

setBorder(top, left, bottom, right, vertical, horizontal)

ตั้งค่าพร็อพเพอร์ตี้เส้นขอบสำหรับ Range แต่ละรายการในรายการช่วง ค่าที่ใช้ได้มีดังนี้ true (เปิด), false (ปิด) และ null (ไม่มีการเปลี่ยนแปลง)

const sheet = SpreadsheetApp.getActiveSheet();
const rangeList = sheet.getRangeList(['A2:B4', 'C1:D4']);
// Sets borders on the top and bottom of the ranges A2:B4 and C1:D4, but leaves
// the left and right unchanged.
rangeList.setBorder(true, null, true, null, false, false);

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
top	Boolean	true สำหรับเส้นขอบ false สำหรับไม่มี null สำหรับไม่มีการเปลี่ยนแปลง
left	Boolean	true สำหรับเส้นขอบ false สำหรับไม่มี null สำหรับไม่มีการเปลี่ยนแปลง
bottom	Boolean	true สำหรับเส้นขอบ false สำหรับไม่มี null สำหรับไม่มีการเปลี่ยนแปลง
right	Boolean	true สำหรับเส้นขอบ false สำหรับไม่มี null สำหรับไม่มีการเปลี่ยนแปลง
vertical	Boolean	true สำหรับเส้นขอบแนวตั้งภายใน false สำหรับไม่มี null สำหรับไม่มีการเปลี่ยนแปลง
horizontal	Boolean	true สำหรับเส้นขอบแนวนอนภายใน false สำหรับไม่มี null สำหรับไม่มีการเปลี่ยนแปลง

รีเทิร์น

RangeList — รายการช่วงนี้สําหรับการต่อเชื่อม

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

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

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

---

setBorder(top, left, bottom, right, vertical, horizontal, color, style)

ตั้งค่าพร็อพเพอร์ตี้เส้นขอบด้วยสีและ/หรือสไตล์สำหรับ Range แต่ละรายการในรายการช่วง ค่าที่ใช้ได้คือ true (เปิด) false (ปิด) และ null (ไม่มีการเปลี่ยนแปลง) สีจะแสดงในรูปแบบการเขียน CSS เช่น '#ffffff' หรือ 'white'

const sheet = SpreadsheetApp.getActiveSheet();
const rangeList = sheet.getRangeList(['A2:B4', 'C1:D4']);
// Sets borders on the top and bottom, but leaves the left and right unchanged
// of the ranges A2:B4 and C1:D4. Also sets the color to 'red', and the border
// to 'DASHED'.
rangeList.setBorder(
    true,
    null,
    true,
    null,
    false,
    false,
    'red',
    SpreadsheetApp.BorderStyle.DASHED,
);

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
top	Boolean	true สำหรับเส้นขอบ false สำหรับไม่มี null สำหรับไม่มีการเปลี่ยนแปลง
left	Boolean	true สำหรับเส้นขอบ false สำหรับไม่มี null สำหรับไม่มีการเปลี่ยนแปลง
bottom	Boolean	true สำหรับเส้นขอบ false สำหรับไม่มี null สำหรับไม่มีการเปลี่ยนแปลง
right	Boolean	true สำหรับเส้นขอบ false สำหรับไม่มี null สำหรับไม่มีการเปลี่ยนแปลง
vertical	Boolean	true สำหรับเส้นขอบแนวตั้งภายใน false สำหรับไม่มี null สำหรับไม่มีการเปลี่ยนแปลง
horizontal	Boolean	true สำหรับเส้นขอบแนวนอนภายใน false สำหรับไม่มี null สำหรับไม่มีการเปลี่ยนแปลง
color	String	สีเส้นขอบในรูปแบบ CSS เช่น '#ffffff' หรือ 'white', null สำหรับสีเริ่มต้น (สีดํา)
style	BorderStyle	รูปแบบของเส้นขอบ null สำหรับรูปแบบเริ่มต้น (ทึบ)

รีเทิร์น

RangeList — รายการช่วงนี้สําหรับการต่อเชื่อม

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

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

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

---

setFontColor(color)

กำหนดสีแบบอักษรให้กับ Range แต่ละรายการในรายการช่วง สีจะแสดงเป็นรูปแบบ CSS เช่น '#ffffff' หรือ 'white'

const sheet = SpreadsheetApp.getActiveSheet();
const rangeList = sheet.getRangeList(['A:A', 'C:C']);
rangeList.setFontColor('red');

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
color	String	สีแบบอักษรในเครื่องหมายของ CSS เช่น '#ffffff' หรือ 'white' ค่า null จะรีเซ็ตสี

รีเทิร์น

RangeList — รายการช่วงนี้สําหรับการต่อเชื่อม

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

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

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

---

setFontFamily(fontFamily)

ตั้งค่าชุดแบบอักษรสำหรับ Range แต่ละรายการในรายการช่วง ชุดแบบอักษรจะอธิบายโดยตัวระบุสตริง เช่น Arial หรือ Roboto

const sheet = SpreadsheetApp.getActiveSheet();
const rangeList = sheet.getRangeList(['A:A', 'C:C']);
rangeList.setFontFamily('Roboto');

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
fontFamily	String	ชุดแบบอักษรที่จะตั้งค่า ค่า null จะรีเซ็ตชุดแบบอักษร

รีเทิร์น

RangeList — รายการช่วงนี้สําหรับการต่อเชื่อม

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

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

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

---

setFontLine(fontLine)

กำหนดรูปแบบบรรทัดแบบอักษรสำหรับ Range แต่ละรายการในรายการช่วง ตัวเลือกรูปแบบเส้นคือ 'underline', 'line-through' หรือ 'none'

const sheet = SpreadsheetApp.getActiveSheet();
const rangeList = sheet.getRangeList(['A:A', 'C:C']);
rangeList.setFontLine('line-through');

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
fontLine	String	รูปแบบบรรทัดแบบอักษร 'underline', 'line-through' หรือ 'none' ค่า null จะรีเซ็ตรูปแบบบรรทัดแบบอักษร

รีเทิร์น

RangeList — รายการช่วงนี้สําหรับการต่อเชื่อม

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

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

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

---

setFontSize(size)

กำหนดขนาดแบบอักษร (เป็นจุด) สำหรับ Range แต่ละรายการในรายการช่วง

const sheet = SpreadsheetApp.getActiveSheet();
const rangeList = sheet.getRangeList(['A:A', 'C:C']);
rangeList.setFontSize(20);

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
size	Integer	ขนาดแบบอักษรเป็นจุด

รีเทิร์น

RangeList — รายการช่วงนี้สําหรับการต่อเชื่อม

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

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

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

---

setFontStyle(fontStyle)

กำหนดสไตล์แบบอักษรสำหรับ Range แต่ละรายการในรายการช่วง ตัวเลือกสไตล์แบบอักษรมีดังนี้ 'italic' หรือ 'normal'

const sheet = SpreadsheetApp.getActiveSheet();
const rangeList = sheet.getRangeList(['A:A', 'C:C']);
rangeList.setFontStyle('italic');

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
fontStyle	String	รูปแบบแบบอักษร 'italic' หรือ 'normal' ค่า null จะรีเซ็ตรูปแบบแบบอักษร

รีเทิร์น

RangeList — รายการช่วงนี้สําหรับการต่อเชื่อม

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

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

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

---

setFontWeight(fontWeight)

กำหนดน้ำหนักแบบอักษรสำหรับ Range แต่ละรายการในรายการช่วง ตัวเลือกน้ำหนักตัวอักษรคือ 'normal' หรือ 'bold'

const sheet = SpreadsheetApp.getActiveSheet();
const rangeList = sheet.getRangeList(['A:A', 'C:C']);
rangeList.setFontWeight('bold');

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
fontWeight	String	น้ำหนักแบบอักษร 'bold' หรือ 'normal' ค่า null จะรีเซ็ตน้ำหนักแบบอักษร

รีเทิร์น

RangeList — รายการช่วงนี้สําหรับการต่อเชื่อม

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

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

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

---

setFormula(formula)

อัปเดตสูตรสำหรับ Range แต่ละรายการในรายการช่วง สูตรที่ระบุต้องอยู่ในรูปแบบ A1

const sheet = SpreadsheetApp.getActiveSheet();
const rangeList = sheet.getRangeList(['A11', 'C11']);
rangeList.setFormula('=SUM(B1:B10)');

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
formula	String	สตริงที่แสดงสูตรที่จะตั้งค่า

รีเทิร์น

RangeList — รายการช่วงนี้สําหรับการต่อเชื่อม

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

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

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

---

setFormulaR1C1(formula)

อัปเดตสูตรสำหรับ Range แต่ละรายการในรายการช่วง สูตรที่ระบุต้องอยู่ในรูปแบบ R1C1

const sheet = SpreadsheetApp.getActiveSheet();
const rangeList = sheet.getRangeList(['A11', 'C11']);
// This sets the formula to be the sum of the 3 rows above B5
rangeList.setFormulaR1C1('=SUM(R[-3]C[0]:R[-1]C[0])');

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
formula	String	สูตรสตริง

รีเทิร์น

RangeList — รายการช่วงนี้สําหรับการต่อเชื่อม

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

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

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

---

setHorizontalAlignment(alignment)

ตั้งค่าการจัดแนวนอนสำหรับ Range แต่ละรายการในรายการช่วง ตัวเลือกการจัดตำแหน่งคือ 'left', 'center' หรือ 'right'

const sheet = SpreadsheetApp.getActiveSheet();
const rangeList = sheet.getRangeList(['A:A', 'C:C']);
rangeList.setHorizontalAlignment('center');

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
alignment	String	การจัดแนว ซึ่งอาจเป็น 'left', 'center' หรือ 'normal' ค่า null จะรีเซ็ตการจัดแนว

รีเทิร์น

RangeList — รายการช่วงนี้สําหรับการต่อเชื่อม

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

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

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

---

setNote(note)

ตั้งค่าข้อความหมายเหตุสำหรับ Range แต่ละรายการในรายการช่วง

const sheet = SpreadsheetApp.getActiveSheet();
const rangeList = sheet.getRangeList(['A:A', 'C:C']);
rangeList.setNote('This is a note');

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
note	String	ข้อความโน้ตที่จะตั้งค่า ค่า null จะนําโน้ตออก

รีเทิร์น

RangeList — รายการช่วงนี้สําหรับการต่อเชื่อม

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

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

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

---

setNumberFormat(numberFormat)

กำหนดรูปแบบตัวเลขหรือวันที่สำหรับ Range แต่ละรายการในรายการช่วง

รูปแบบการจัดรูปแบบที่ยอมรับจะอธิบายไว้ในคู่มือการจัดรูปแบบวันที่และตัวเลขของ Sheets API

const sheet = SpreadsheetApp.getActiveSheet();
const rangeList = sheet.getRangeList(['A1:A10', 'C1:C10']);
// Always show 3 decimal points for the specified ranges.
rangeList.setNumberFormat('0.000');

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
numberFormat	String	สตริงรูปแบบตัวเลข

รีเทิร์น

RangeList — รายการช่วงนี้สําหรับการต่อเชื่อม

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

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

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

---

setShowHyperlink(showHyperlink)

ตั้งค่าว่าแต่ละ Range ในรายการช่วงควรแสดงไฮเปอร์ลิงก์หรือไม่

const sheet = SpreadsheetApp.getActiveSheet();
const rangeList = sheet.getRangeList(['A1:A10', 'C1:C10']);
// Show hyperlinks for all the ranges.
rangeList.setShowHyperlink(true);

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
showHyperlink	Boolean	แสดงไฮเปอร์ลิงก์หรือไม่

รีเทิร์น

RangeList — รายการช่วงนี้สําหรับการต่อเชื่อม

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

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

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

---

setTextDirection(direction)

กำหนดทิศทางข้อความสำหรับเซลล์ในแต่ละ Range ในรายการช่วง หากทิศทางที่ระบุคือ null ระบบจะอนุมานทิศทางแล้วตั้งค่า

// Sets right-to-left text direction each range in the range list.
const sheet = SpreadsheetApp.getActiveSheet();
const rangeList = sheet.getRangeList(['A1:A10', 'C1:C10']);
rangeList.setTextDirection(SpreadsheetApp.TextDirection.RIGHT_TO_LEFT);

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
direction	TextDirection	ทิศทางข้อความที่ต้องการ หากเป็น null ระบบจะอนุมานทิศทางก่อนการตั้งค่า

รีเทิร์น

RangeList — รายการช่วงนี้สําหรับการต่อเชื่อม

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

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

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

---

setTextRotation(degrees)

ตั้งค่าการหมุนข้อความสำหรับเซลล์ในแต่ละ Range ในรายการช่วง ข้อมูลที่ป้อนจะสอดคล้องกับมุมระหว่างการวางแนวข้อความมาตรฐานกับการวางแนวที่ต้องการ การป้อนค่า 0 บ่งชี้ว่าข้อความได้รับการตั้งค่าให้อยู่ในแนวนอนมาตรฐาน

สำหรับทิศทางข้อความจากซ้ายไปขวา มุมบวกจะเป็นไปในทิศทางทวนเข็มนาฬิกา ส่วนมุมลบจะเป็นไปในทิศทางตามเข็มนาฬิกา

// Sets the cells in the ranges A1:A10 and C1:C10 to have text rotated up 45
// degrees.
const sheet = SpreadsheetApp.getActiveSheet();
const rangeList = sheet.getRangeList(['A1:A10', 'C1:C10']);
rangeList.setTextRotation(45);

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
degrees	Integer	มุมที่ต้องการระหว่างการวางแนวมาตรฐานกับการวางแนวที่ต้องการ สำหรับข้อความแบบซ้ายไปขวา มุมบวกจะอยู่ในทิศทางทวนเข็มนาฬิกา

รีเทิร์น

RangeList — รายการช่วงนี้สําหรับการต่อเชื่อม

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

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

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

---

setValue(value)

ตั้งค่าสำหรับ Range แต่ละรายการในรายการช่วง ค่าอาจเป็นตัวเลข สตริง บูลีน หรือวันที่ หากขึ้นต้นด้วย "=" ระบบจะตีความว่าเป็นสูตร

const sheet = SpreadsheetApp.getActiveSheet();
// Set value of 100 to each range in the range list.
const rangeList = sheet.getRangeList(['A:A', 'C:C']);
rangeList.setValue(100);

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
value	Object	ค่าของช่วง

รีเทิร์น

RangeList — รายการช่วงนี้สําหรับการต่อเชื่อม

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

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

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

---

setVerticalAlignment(alignment)

ตั้งค่าการจัดแนวตั้งสำหรับ Range แต่ละรายการในรายการช่วง ตัวเลือกการจัดตำแหน่งคือ 'top', 'middle' หรือ 'bottom'

// Sets the vertical alignment to middle for the list of ranges.
const sheet = SpreadsheetApp.getActiveSheet();
const rangeList = sheet.getRangeList(['D4', 'B2:C4']);
rangeList.setVerticalAlignment('middle');

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
alignment	String	การจัดแนว ซึ่งอาจเป็น 'top', 'middle' หรือ 'bottom' ค่า null จะรีเซ็ตการจัดแนว

รีเทิร์น

RangeList — รายการช่วงนี้สําหรับการต่อเชื่อม

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

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

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

---

setVerticalText(isVertical)

ตั้งค่าว่าจะซ้อนข้อความสำหรับเซลล์ของ Range แต่ละรายการในรายการช่วงหรือไม่ หากข้อความซ้อนกันแนวตั้ง ระบบจะไม่สนใจการตั้งค่าการหมุนข้อความเป็นองศา

// Sets all cell's in ranges D4 and B2:D4 to have vertically stacked text.
const sheet = SpreadsheetApp.getActiveSheet();
const rangeList = sheet.getRangeList(['D4', 'B2:C4']);
rangeList.setVerticalText(true);

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
isVertical	Boolean	เลือกว่าจะซ้อนข้อความหรือไม่

รีเทิร์น

RangeList — รายการช่วงนี้สําหรับการต่อเชื่อม

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

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

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

---

setWrap(isWrapEnabled)

ตั้งค่าการขึ้นบรรทัดใหม่ของข้อความสำหรับ Range แต่ละรายการในรายการช่วง เซลล์ที่เปิดใช้การตัดคำจะปรับขนาดเพื่อแสดงเนื้อหาทั้งหมด เซลล์ที่ปิดใช้การตัดข้อความแสดงผลมากที่สุดในเซลล์โดยไม่ต้องปรับขนาดหรือแสดงหลายบรรทัด

// Enable text wrap for the list of ranges.
const sheet = SpreadsheetApp.getActiveSheet();
const rangeList = sheet.getRangeList(['D4', 'B2:C4']);
rangeList.setWrap(true);

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
isWrapEnabled	Boolean	เลือกว่าจะตัดข้อความขึ้นบรรทัดใหม่หรือไม่

รีเทิร์น

RangeList — รายการช่วงนี้สําหรับการต่อเชื่อม

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

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

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

---

setWrapStrategy(strategy)

ตั้งค่ากลยุทธ์การตัดข้อความสำหรับ Range แต่ละรายการในรายการช่วง

// Sets the list of ranges to use the clip wrap strategy.
const sheet = SpreadsheetApp.getActiveSheet();
const rangeList = sheet.getRangeList(['D4', 'B2:C4']);
rangeList.setWrapStrategy(SpreadsheetApp.WrapStrategy.CLIP);

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
strategy	WrapStrategy	กลยุทธ์การตัดข้อความที่ต้องการ

รีเทิร์น

RangeList — รายการช่วงนี้สําหรับการต่อเชื่อม

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

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

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

---

trimWhitespace()

ตัดช่องว่าง (เช่น เว้นวรรค แท็บ หรือบรรทัดใหม่) ในทุกเซลล์ในรายการช่วงนี้ นำช่องว่างทั้งหมดออกจากต้นและท้ายข้อความของแต่ละเซลล์ และลดลำดับย่อยของอักขระที่เป็นช่องว่างที่เหลือให้เป็นช่องว่างเดี่ยว

หมายเหตุ: หากข้อความที่ตัดผลลัพธ์ขึ้นต้นด้วยอักขระ '+' หรือ '=' ข้อความจะยังคงเป็นค่าสตริงและจะไม่ได้รับการตีความว่าเป็นสูตร

const sheet = SpreadsheetApp.getActiveSpreadsheet().getSheets()[0];
const range = sheet.getRange('A1:A4');
range.activate();
range.setValues([
  ' preceding space',
  'following space ',
  'two  middle  spaces',
  '   =SUM(1,2)',
]);

const rangeList = sheet.getRangeList(['A1', 'A2', 'A3', 'A4']);
rangeList.trimWhitespace();

const values = range.getValues();
// Values are ['preceding space', 'following space', 'two middle spaces',
// '=SUM(1,2)']

รีเทิร์น

RangeList — รายการช่วงนี้สําหรับการต่อเชื่อม

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

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

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

ดูเพิ่มเติม

• Range.trimWhitespace()

---

uncheck()

เปลี่ยนสถานะของช่องทําเครื่องหมายในช่วงเป็น "ไม่ได้เลือก" จะไม่สนใจเซลล์ในช่วงซึ่งปัจจุบันไม่มีค่าที่เลือกหรือไม่ได้เลือกไว้

// Changes the state of cells which currently contain either the checked or
// unchecked value configured in the ranges D4 and E6 to 'unchecked'.
const rangeList = SpreadsheetApp.getActive().getRangeList(['D4', 'E6']);
rangeList.uncheck();

รีเทิร์น

RangeList — รายการช่วงนี้สําหรับการต่อเชื่อม

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

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

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