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

พารามิเตอร์

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

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

ชื่อประเภทคำอธิบาย
commentsOnlyBooleanเลือกว่าจะล้างเฉพาะความคิดเห็นหรือไม่
contentsOnlyBooleanจะล้างเฉพาะเนื้อหาหรือไม่
formatOnlyBooleanเลือกว่าจะล้างเฉพาะรูปแบบหรือไม่ โปรดทราบว่าการล้าง รูปแบบจะล้างกฎการตรวจสอบข้อมูลด้วย
validationsOnlyBooleanเลือกว่าจะล้างเฉพาะกฎการตรวจสอบข้อมูลหรือไม่
skipFilteredRowsBooleanกำหนดว่าจะหลีกเลี่ยงการล้างแถวที่กรองหรือไม่

รีเทิร์น

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');

พารามิเตอร์

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

รีเทิร์น

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');

พารามิเตอร์

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

รีเทิร์น

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');

พารามิเตอร์

ชื่อประเภทคำอธิบาย
colorStringรหัสสีพื้นหลังในรูปแบบ 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);

พารามิเตอร์

ชื่อประเภทคำอธิบาย
redIntegerค่าสีแดงในสัญกรณ์ RGB
greenIntegerค่าสีเขียวในสัญกรณ์ RGB
blueIntegerค่าสีน้ำเงินในสัญกรณ์ 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);

พารามิเตอร์

ชื่อประเภทคำอธิบาย
topBooleantrue สำหรับเส้นขอบ false สำหรับไม่มี null สำหรับไม่มีการเปลี่ยนแปลง
leftBooleantrue สำหรับเส้นขอบ false สำหรับไม่มี null สำหรับไม่มีการเปลี่ยนแปลง
bottomBooleantrue สำหรับเส้นขอบ false สำหรับไม่มี null สำหรับไม่มีการเปลี่ยนแปลง
rightBooleantrue สำหรับเส้นขอบ false สำหรับไม่มี null สำหรับไม่มีการเปลี่ยนแปลง
verticalBooleantrue สำหรับเส้นขอบแนวตั้งภายใน false สำหรับไม่มี null สำหรับไม่มีการเปลี่ยนแปลง
horizontalBooleantrue สำหรับเส้นขอบแนวนอนภายใน 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,
);

พารามิเตอร์

ชื่อประเภทคำอธิบาย
topBooleantrue สำหรับเส้นขอบ false สำหรับไม่มี null สำหรับไม่มีการเปลี่ยนแปลง
leftBooleantrue สำหรับเส้นขอบ false สำหรับไม่มี null สำหรับไม่มีการเปลี่ยนแปลง
bottomBooleantrue สำหรับเส้นขอบ false สำหรับไม่มี null สำหรับไม่มีการเปลี่ยนแปลง
rightBooleantrue สำหรับเส้นขอบ false สำหรับไม่มี null สำหรับไม่มีการเปลี่ยนแปลง
verticalBooleantrue สำหรับเส้นขอบแนวตั้งภายใน false สำหรับไม่มี null สำหรับไม่มีการเปลี่ยนแปลง
horizontalBooleantrue สำหรับเส้นขอบแนวนอนภายใน false สำหรับไม่มี null สำหรับไม่มีการเปลี่ยนแปลง
colorStringสีเส้นขอบในรูปแบบ CSS เช่น '#ffffff' หรือ 'white', null สำหรับสีเริ่มต้น (สีดำ)
styleBorderStyleรูปแบบของเส้นขอบ 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');

พารามิเตอร์

ชื่อประเภทคำอธิบาย
colorStringสีแบบอักษรในรูปแบบ 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');

พารามิเตอร์

ชื่อประเภทคำอธิบาย
fontFamilyStringชุดแบบอักษรที่จะตั้งค่า ค่า 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');

พารามิเตอร์

ชื่อประเภทคำอธิบาย
fontLineStringรูปแบบเส้นแบบอักษรเป็น '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);

พารามิเตอร์

ชื่อประเภทคำอธิบาย
sizeIntegerขนาดแบบอักษรในหน่วยพอยต์

รีเทิร์น

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');

พารามิเตอร์

ชื่อประเภทคำอธิบาย
fontStyleStringรูปแบบแบบอักษร ซึ่งอาจเป็น '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');

พารามิเตอร์

ชื่อประเภทคำอธิบาย
fontWeightStringน้ำหนักแบบอักษร ซึ่งอาจเป็น '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)');

พารามิเตอร์

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

รีเทิร์น

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])');

พารามิเตอร์

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

รีเทิร์น

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');

พารามิเตอร์

ชื่อประเภทคำอธิบาย
alignmentStringการจัดแนวเป็น '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');

พารามิเตอร์

ชื่อประเภทคำอธิบาย
noteStringข้อความหมายเหตุที่จะตั้งค่า 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');

พารามิเตอร์

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

รีเทิร์น

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

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

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

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

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

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

พารามิเตอร์

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

รีเทิร์น

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);

พารามิเตอร์

ชื่อประเภทคำอธิบาย
directionTextDirectionทิศทางข้อความที่ต้องการ หาก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);

พารามิเตอร์

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

รีเทิร์น

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);

พารามิเตอร์

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

รีเทิร์น

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');

พารามิเตอร์

ชื่อประเภทคำอธิบาย
alignmentStringการจัดแนวเป็น '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);

พารามิเตอร์

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

รีเทิร์น

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);

พารามิเตอร์

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

รีเทิร์น

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);

พารามิเตอร์

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

รีเทิร์น

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

ดูเพิ่มเติม

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