หน้านี้ได้รับการแปลโดย Cloud Translation API

Class 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

หมายเหตุ: วิธีนี้จะแสดงวิธีเลือกช่วงหลายช่วงได้

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

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

รีเทิร์น

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

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

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

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

`breakApart()`

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

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

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

รีเทิร์น

RangeList — รายการช่วงนี้สำหรับการทำเชน

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

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'.
var rangeList = SpreadsheetApp.getActive().getRangeList(['D4', 'E6']);
rangeList.check();

รีเทิร์น

RangeList — รายการช่วงนี้สำหรับการทำเชน

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

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

`clear()`

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

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

รีเทิร์น

RangeList — รายการช่วงนี้สำหรับการทำเชน

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

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.
var sheet = SpreadsheetApp.getActiveSheet();
var rangeList = sheet.getRangeList(['A:A', 'C:C']);
rangeList.clear({contentsOnly: true});

พารามิเตอร์

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

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

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

รีเทิร์น

RangeList — รายการช่วงนี้สำหรับการทำเชน

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

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

`clearContent()`

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

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

รีเทิร์น

RangeList — รายการช่วงนี้สำหรับการทำเชน

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

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

`clearDataValidations()`

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

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

รีเทิร์น

RangeList — รายการช่วงนี้สำหรับการทำเชน

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

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

`clearFormat()`

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

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

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

รีเทิร์น

RangeList — รายการช่วงนี้สำหรับการทำเชน

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

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

`clearNote()`

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

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

รีเทิร์น

RangeList — รายการช่วงนี้สำหรับการทำเชน

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

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

`getRanges()`

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

รีเทิร์น

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

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

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

`insertCheckboxes()`

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

var 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 — รายการช่วงนี้สำหรับการทำเชน

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

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

`insertCheckboxes(checkedValue)`

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

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

พารามิเตอร์

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

รีเทิร์น

RangeList — รายการช่วงนี้สำหรับการทำเชน

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

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

`insertCheckboxes(checkedValue, uncheckedValue)`

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

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

พารามิเตอร์

ชื่อ	Type	คำอธิบาย
`checkedValue`	`Object`	ค่าที่ทำเครื่องหมายสำหรับการตรวจสอบข้อมูลของช่องทำเครื่องหมาย
`uncheckedValue`	`Object`	ค่าที่ยกเลิกการเลือกสำหรับการตรวจสอบข้อมูลในช่องทำเครื่องหมาย

รีเทิร์น

RangeList — รายการช่วงนี้สำหรับการทำเชน

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

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

`removeCheckboxes()`

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

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

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

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

var 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 — รายการช่วงนี้สำหรับการทำเชน

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

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

`setBackground(color)`

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

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

พารามิเตอร์

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

รีเทิร์น

RangeList — รายการช่วงนี้สำหรับการทำเชน

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

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

`setBackgroundRGB(red, green, blue)`

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

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

พารามิเตอร์

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

รีเทิร์น

RangeList — รายการช่วงนี้สำหรับการทำเชน

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

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

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

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

var sheet = SpreadsheetApp.getActiveSheet();
var 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);

พารามิเตอร์

ชื่อ	Type	คำอธิบาย
`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 — รายการช่วงนี้สำหรับการทำเชน

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

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'

var sheet = SpreadsheetApp.getActiveSheet();
var 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);

พารามิเตอร์

ชื่อ	Type	คำอธิบาย
`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 — รายการช่วงนี้สำหรับการทำเชน

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

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

`setFontColor(color)`

ตั้งค่าสีแบบอักษรสําหรับ Range แต่ละรายการในรายการช่วง สีจะแสดงในสัญลักษณ์ CSS เช่น '#ffffff' หรือ 'white'

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

พารามิเตอร์

ชื่อ	Type	คำอธิบาย
`color`	`String`	สีแบบอักษรในสัญลักษณ์ CSS เช่น `'#ffffff'` หรือ `'white'` ค่า `null` จะรีเซ็ตสี

รีเทิร์น

RangeList — รายการช่วงนี้สำหรับการทำเชน

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

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

`setFontFamily(fontFamily)`

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

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

พารามิเตอร์

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

รีเทิร์น

RangeList — รายการช่วงนี้สำหรับการทำเชน

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

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

`setFontLine(fontLine)`

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

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

พารามิเตอร์

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

รีเทิร์น

RangeList — รายการช่วงนี้สำหรับการทำเชน

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

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

`setFontSize(size)`

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

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

พารามิเตอร์

ชื่อ	Type	คำอธิบาย
`size`	`Integer`	ขนาดจุดแบบอักษร

รีเทิร์น

RangeList — รายการช่วงนี้สำหรับการทำเชน

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

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

`setFontStyle(fontStyle)`

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

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

พารามิเตอร์

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

รีเทิร์น

RangeList — รายการช่วงนี้สำหรับการทำเชน

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

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

`setFontWeight(fontWeight)`

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

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

พารามิเตอร์

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

รีเทิร์น

RangeList — รายการช่วงนี้สำหรับการทำเชน

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

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

`setFormula(formula)`

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

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

พารามิเตอร์

ชื่อ	Type	คำอธิบาย
`formula`	`String`	สตริงแทนสูตรที่ต้องการตั้งค่า

รีเทิร์น

RangeList — รายการช่วงนี้สำหรับการทำเชน

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

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

`setFormulaR1C1(formula)`

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

var sheet = SpreadsheetApp.getActiveSheet();
var 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])');

พารามิเตอร์

ชื่อ	Type	คำอธิบาย
`formula`	`String`	สูตรสตริง

รีเทิร์น

RangeList — รายการช่วงนี้สำหรับการทำเชน

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

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

`setHorizontalAlignment(alignment)`

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

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

พารามิเตอร์

ชื่อ	Type	คำอธิบาย
`alignment`	`String`	การปรับแนว ได้แก่ `'left'`, `'center'` หรือ `'normal'` และค่า `null` จะรีเซ็ตการปรับแนว

รีเทิร์น

RangeList — รายการช่วงนี้สำหรับการทำเชน

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

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

`setNote(note)`

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

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

พารามิเตอร์

ชื่อ	Type	คำอธิบาย
`note`	`String`	ข้อความโน้ตที่จะตั้งค่า ค่า `null` จะลบโน้ตออก

รีเทิร์น

RangeList — รายการช่วงนี้สำหรับการทำเชน

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

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

`setNumberFormat(numberFormat)`

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

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

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

พารามิเตอร์

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

รีเทิร์น

RangeList — รายการช่วงนี้สำหรับการทำเชน

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

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

`setShowHyperlink(showHyperlink)`

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

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

พารามิเตอร์

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

รีเทิร์น

RangeList — รายการช่วงนี้สำหรับการทำเชน

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

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.
var sheet = SpreadsheetApp.getActiveSheet();
var rangeList = sheet.getRangeList(['A1:A10', 'C1:C10']);
rangeList.setTextDirection(SpreadsheetApp.TextDirection.RIGHT_TO_LEFT);

พารามิเตอร์

ชื่อ	Type	คำอธิบาย
`direction`	`TextDirection`	ทิศทางข้อความที่ต้องการ หาก `null` มีการอนุมานทิศทางก่อนการตั้งค่า

รีเทิร์น

RangeList — รายการช่วงนี้สำหรับการทำเชน

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

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.
var sheet = SpreadsheetApp.getActiveSheet();
var rangeList = sheet.getRangeList(['A1:A10', 'C1:C10']);
rangeList.setTextRotation(45);

พารามิเตอร์

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

รีเทิร์น

RangeList — รายการช่วงนี้สำหรับการทำเชน

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

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

`setValue(value)`

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

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

พารามิเตอร์

ชื่อ	Type	คำอธิบาย
`value`	`Object`	ค่าของช่วง

รีเทิร์น

RangeList — รายการช่วงนี้สำหรับการทำเชน

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

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.
var sheet = SpreadsheetApp.getActiveSheet();
var rangeList = sheet.getRangeList(['D4', 'B2:C4']);
rangeList.setVerticalAlignment("middle");

พารามิเตอร์

ชื่อ	Type	คำอธิบาย
`alignment`	`String`	การปรับแนว ได้แก่ `'top'`, `'middle'` หรือ `'bottom'` และค่า `null` จะรีเซ็ตการปรับแนว

รีเทิร์น

RangeList — รายการช่วงนี้สำหรับการทำเชน

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

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.
var sheet = SpreadsheetApp.getActiveSheet();
var rangeList = sheet.getRangeList(['D4', 'B2:C4']);
rangeList.setVerticalText(true);

พารามิเตอร์

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

รีเทิร์น

RangeList — รายการช่วงนี้สำหรับการทำเชน

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

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

`setWrap(isWrapEnabled)`

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

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

พารามิเตอร์

ชื่อ	Type	คำอธิบาย
`isWrapEnabled`	`Boolean`	ตัดข้อความขึ้นบรรทัดใหม่

รีเทิร์น

RangeList — รายการช่วงนี้สำหรับการทำเชน

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

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.
var sheet = SpreadsheetApp.getActiveSheet();
var rangeList = sheet.getRangeList(['D4', 'B2:C4']);
rangeList.setWrapStrategy(SpreadsheetApp.WrapStrategy.CLIP);

พารามิเตอร์

ชื่อ	Type	คำอธิบาย
`strategy`	`WrapStrategy`	กลยุทธ์การสรุปที่ต้องการ

รีเทิร์น

RangeList — รายการช่วงนี้สำหรับการทำเชน

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

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

`trimWhitespace()`

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

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

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

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

รีเทิร์น

RangeList — รายการช่วงนี้สำหรับการทำเชน

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

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'.
var rangeList = SpreadsheetApp.getActive().getRangeList(['D4', 'E6']);
rangeList.uncheck();

รีเทิร์น

RangeList — รายการช่วงนี้สำหรับการทำเชน

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

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