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 ในรายการช่วง

รูปแบบการจัดรูปแบบที่ยอมรับจะอธิบายไว้ในคู่มือการจัดรูปแบบวันที่และตัวเลขของชีต 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