หน้านี้ได้รับการแปลโดย 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});

พารามิเตอร์

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

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

ชื่อ	ประเภท	คำอธิบาย
`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');

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
`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');

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
`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');

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
`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);

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
`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 (เปิด), 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);

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
`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);

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
`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');

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
`color`	`String`	สีแบบอักษรในรูปแบบ CSS เช่น `'#ffffff'` หรือ `'white'` CANNOT TRANSLATE ค่า `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');

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
`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');

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
`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);

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
`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");

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
`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');

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
`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)');

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
`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])');

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
`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");

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
`alignment`	`String`	การจัดข้อความ `'left'`, `'center'` หรือ `'normal'` CANNOT TRANSLATE ค่า `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');

พารามิเตอร์

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

รีเทิร์น

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

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

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

`setNumberFormat(numberFormat)`

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

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

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
`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);

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
`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);

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
`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);

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
`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);

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
`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");

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
`alignment`	`String`	การจัดข้อความ `'top'`, `'middle'` หรือ `'bottom'` CANNOT TRANSLATE ค่า `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);

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
`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);

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
`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);

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
`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