เข้าถึงและแก้ไขกลุ่มสเปรดชีต กลุ่มคือการเชื่อมโยงระหว่างช่วงของแถวหรือคอลัมน์ที่ต่อเนื่องกัน ซึ่งสามารถขยายหรือยุบเป็นหน่วยเพื่อซ่อน/แสดงแถวหรือคอลัมน์ แต่ละกลุ่มมีปุ่มสลับการควบคุมในแถวหรือคอลัมน์ที่อยู่ก่อนหรือหลังกลุ่มโดยตรง (ขึ้นอยู่กับการตั้งค่า) ที่ขยายหรือยุบกลุ่มโดยรวมได้
ความลึกของกลุ่มหมายถึงตำแหน่งที่ซ้อนกันของกลุ่มและจำนวนกลุ่มที่ใหญ่กว่านั้นที่มีกลุ่มนั้นอยู่ สถานะยุบของกลุ่มเป็นการบอกว่ากลุ่มควรยุบหรือขยายต่อไปหลังจากขยายกลุ่มหลัก นอกจากนี้ เมื่อระบบยุบหรือขยายกลุ่ม ระบบจะซ่อนแถวหรือคอลัมน์ภายในกลุ่มหรือตั้งค่าให้มองเห็นได้ แม้ว่าแถวหรือคอลัมน์จะซ่อนอยู่หรือตั้งค่าให้มองเห็นได้โดยไม่คำนึงถึงสถานะยุบ
วิธีการ
วิธีการ | ประเภทการแสดงผล | รายละเอียดแบบย่อ |
---|---|---|
collapse() | Group | ยุบกลุ่มนี้ |
expand() | Group | ขยายกลุ่มนี้ |
getControlIndex() | Integer | แสดงผลดัชนีการสลับการควบคุมของกลุ่มนี้ |
getDepth() | Integer | แสดงผลความลึกของกลุ่มนี้ |
getRange() | Range | แสดงผลช่วงที่มีกลุ่มนี้อยู่ |
isCollapsed() | Boolean | แสดงผล true ถ้ากลุ่มนี้ยุบอยู่ |
remove() | void | นำกลุ่มนี้ออกจากชีตโดยลดความลึกของกลุ่มของ range ลง 1 ตัว |
เอกสารประกอบโดยละเอียด
collapse()
ยุบกลุ่มนี้
var sheet = SpreadsheetApp.getActiveSpreadsheet().getSheets()[0]; var range = sheet.getRange(2:3); range.shiftRowGroupDepth(1); var group = sheet.getRowGroup(2, 1); // Collapses this group. group.collapse();
รีเทิร์น
Group
— กลุ่มนี้สำหรับการทำเชน
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้ต้องได้รับสิทธิ์จากขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
expand()
ขยายกลุ่มนี้
var sheet = SpreadsheetApp.getActiveSpreadsheet().getSheets()[0]; var range = sheet.getRange(2:3); range.shiftRowGroupDepth(1); var group = sheet.getRowGroup(2, 1); // Expands this group. group.expand();
รีเทิร์น
Group
— กลุ่มนี้สำหรับการทำเชน
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้ต้องได้รับสิทธิ์จากขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getControlIndex()
แสดงผลดัชนีการสลับการควบคุมของกลุ่มนี้ ดัชนีนี้จะเป็นดัชนีก่อนช่วงเมื่อปุ่มสลับตัวควบคุมแสดงก่อนกลุ่ม หรือดัชนีอยู่หลังช่วง
var sheet = SpreadsheetApp.getActiveSpreadsheet().getSheets()[0]; sheet.setRowGroupControlAfter(true); var range = sheet.getRange(2:3); range.shiftRowGroupDepth(1); var group = sheet.getRowGroup(2, 1); // Returns 4 var controlIndex = group.getControlIndex();
รีเทิร์น
Integer
— ดัชนีเปิด/ปิดการควบคุมของกลุ่มนี้
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้ต้องได้รับสิทธิ์จากขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getDepth()
แสดงผลความลึกของกลุ่มนี้
var sheet = SpreadsheetApp.getActiveSpreadsheet().getSheets()[0]; var range = sheet.getRange(2:3); range.shiftRowGroupDepth(1); var group = sheet.getRowGroup(2, 1); // Returns 1 if the group is at depth 1. var depth = group.getDepth();
รีเทิร์น
Integer
— ความลึกของกลุ่มนี้
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้ต้องได้รับสิทธิ์จากขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getRange()
แสดงผลช่วงที่มีกลุ่มนี้อยู่
var sheet = SpreadsheetApp.getActiveSpreadsheet().getSheets()[0]; var range = sheet.getRange(2:3); range.shiftRowGroupDepth(1); var group = sheet.getRowGroup(1, 1); // Returns the range 2:3 if the group is over rows 2:3 range = group.getRange();
รีเทิร์น
Range
— ช่วงที่มีกลุ่มอยู่
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้ต้องได้รับสิทธิ์จากขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
isCollapsed()
แสดงผล true
ถ้ากลุ่มนี้ยุบอยู่
var sheet = SpreadsheetApp.getActiveSpreadsheet().getSheets()[0]; var range = sheet.getRange(2:3); range.shiftRowGroupDepth(1); var group = sheet.getRowGroup(2, 1); // Returns true if the group is collapsed. var isCollapsed = group.isCollapsed();
รีเทิร์น
Boolean
— true
หากกลุ่มนี้ยุบอยู่ แสดงผล false
ในกรณีอื่นๆ
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้ต้องได้รับสิทธิ์จากขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
remove()
นำกลุ่มนี้ออกจากชีตโดยลดความลึกของกลุ่มของ range
ลง 1 ตัว การดำเนินการนี้อาจแก้ไขกลุ่มอื่นๆ หลังจากเรียกใช้รายการนี้ ออบเจ็กต์กลุ่มจะใช้ไม่ได้
var sheet = SpreadsheetApp.getActiveSpreadsheet().getSheets()[0]; var range = sheet.getRange(2:3); range.shiftRowGroupDepth(1); var group = sheet.getRowGroup(2, 1); // Removes this group var range = group.remove();
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้ต้องได้รับสิทธิ์จากขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets