Class Group

กลุ่ม

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

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

วิธีการ

วิธีการประเภทการแสดงผลรายละเอียดแบบย่อ
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();

รีเทิร์น

Booleantrue หากกลุ่มนี้ยุบอยู่ แสดงผล 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

ดูเพิ่มเติม