คอลเล็กชันของอินสแตนซ์ 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
— รายการช่วงนี้สำหรับการทำเชน
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้ต้องได้รับสิทธิ์จากขอบเขตต่อไปนี้อย่างน้อย 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'. var 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
แต่ละรายการในรายการช่วง
var sheet = SpreadsheetApp.getActiveSheet(); var 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. 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
— รายการช่วงนี้สำหรับการทำเชน
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้ต้องได้รับสิทธิ์จากขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
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
— รายการช่วงนี้สำหรับการทำเชน
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้ต้องได้รับสิทธิ์จากขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
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
— รายการช่วงนี้สำหรับการทำเชน
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้ต้องได้รับสิทธิ์จากขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
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
— รายการช่วงนี้สำหรับการทำเชน
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้ต้องได้รับสิทธิ์จากขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
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
— รายการช่วงนี้สำหรับการทำเชน
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้ต้องได้รับสิทธิ์จากขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getRanges()
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
— รายการช่วงนี้สำหรับการทำเชน
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้ต้องได้รับสิทธิ์จากขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
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
— รายการช่วงนี้สำหรับการทำเชน
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้ต้องได้รับสิทธิ์จากขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
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
— รายการช่วงนี้สำหรับการทำเชน
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้ต้องได้รับสิทธิ์จากขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
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
— รายการช่วงนี้สำหรับการทำเชน
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้ต้องได้รับสิทธิ์จากขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
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
— รายการช่วงนี้สำหรับการทำเชน
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้ต้องได้รับสิทธิ์จากขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
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
— รายการช่วงนี้สำหรับการทำเชน
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้ต้องได้รับสิทธิ์จากขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
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
— รายการช่วงนี้สำหรับการทำเชน
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้ต้องได้รับสิทธิ์จากขอบเขตต่อไปนี้อย่างน้อย 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'
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
— รายการช่วงนี้สำหรับการทำเชน
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้ต้องได้รับสิทธิ์จากขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
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
— รายการช่วงนี้สำหรับการทำเชน
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้ต้องได้รับสิทธิ์จากขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
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
— รายการช่วงนี้สำหรับการทำเชน
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้ต้องได้รับสิทธิ์จากขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
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
— รายการช่วงนี้สำหรับการทำเชน
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้ต้องได้รับสิทธิ์จากขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
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
— รายการช่วงนี้สำหรับการทำเชน
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้ต้องได้รับสิทธิ์จากขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
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
— รายการช่วงนี้สำหรับการทำเชน
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้ต้องได้รับสิทธิ์จากขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
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
— รายการช่วงนี้สำหรับการทำเชน
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้ต้องได้รับสิทธิ์จากขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
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
— รายการช่วงนี้สำหรับการทำเชน
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้ต้องได้รับสิทธิ์จากขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
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
— รายการช่วงนี้สำหรับการทำเชน
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้ต้องได้รับสิทธิ์จากขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
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
— รายการช่วงนี้สำหรับการทำเชน
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้ต้องได้รับสิทธิ์จากขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
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
— รายการช่วงนี้สำหรับการทำเชน
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้ต้องได้รับสิทธิ์จากขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
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
— รายการช่วงนี้สำหรับการทำเชน
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้ต้องได้รับสิทธิ์จากขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
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
— รายการช่วงนี้สำหรับการทำเชน
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้ต้องได้รับสิทธิ์จากขอบเขตต่อไปนี้อย่างน้อย 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. var sheet = SpreadsheetApp.getActiveSheet(); var rangeList = sheet.getRangeList(['A1:A10', 'C1:C10']); rangeList.setTextDirection(SpreadsheetApp.TextDirection.RIGHT_TO_LEFT);
พารามิเตอร์
ชื่อ | Type | คำอธิบาย |
---|---|---|
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. var sheet = SpreadsheetApp.getActiveSheet(); var rangeList = sheet.getRangeList(['A1:A10', 'C1:C10']); rangeList.setTextRotation(45);
พารามิเตอร์
ชื่อ | Type | คำอธิบาย |
---|---|---|
degrees | Integer | มุมที่ต้องการระหว่างการวางแนวมาตรฐานและการวางแนวที่ต้องการ สำหรับข้อความจากซ้ายไปขวา มุมบวกจะอยู่ในทิศทางทวนเข็มนาฬิกา |
รีเทิร์น
RangeList
— รายการช่วงนี้สำหรับการทำเชน
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้ต้องได้รับสิทธิ์จากขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
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
— รายการช่วงนี้สำหรับการทำเชน
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้ต้องได้รับสิทธิ์จากขอบเขตต่อไปนี้อย่างน้อย 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. var sheet = SpreadsheetApp.getActiveSheet(); var rangeList = sheet.getRangeList(['D4', 'B2:C4']); rangeList.setVerticalAlignment("middle");
พารามิเตอร์
ชื่อ | Type | คำอธิบาย |
---|---|---|
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. var sheet = SpreadsheetApp.getActiveSheet(); var rangeList = sheet.getRangeList(['D4', 'B2:C4']); rangeList.setVerticalText(true);
พารามิเตอร์
ชื่อ | Type | คำอธิบาย |
---|---|---|
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. var sheet = SpreadsheetApp.getActiveSheet(); var rangeList = sheet.getRangeList(['D4', 'B2:C4']); rangeList.setWrap(true);
พารามิเตอร์
ชื่อ | Type | คำอธิบาย |
---|---|---|
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. var sheet = SpreadsheetApp.getActiveSheet(); var rangeList = sheet.getRangeList(['D4', 'B2:C4']); rangeList.setWrapStrategy(SpreadsheetApp.WrapStrategy.CLIP);
พารามิเตอร์
ชื่อ | Type | คำอธิบาย |
---|---|---|
strategy | WrapStrategy | กลยุทธ์การสรุปที่ต้องการ |
รีเทิร์น
RangeList
— รายการช่วงนี้สำหรับการทำเชน
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้ต้องได้รับสิทธิ์จากขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
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
— รายการช่วงนี้สำหรับการทำเชน
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้ต้องได้รับสิทธิ์จากขอบเขตต่อไปนี้อย่างน้อย 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'. var rangeList = SpreadsheetApp.getActive().getRangeList(['D4', 'E6']); rangeList.uncheck();
รีเทิร์น
RangeList
— รายการช่วงนี้สำหรับการทำเชน
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้ต้องได้รับสิทธิ์จากขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets