Class Group

กลุ่ม

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

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

เมธอด

วิธีการประเภทการแสดงผลรายละเอียดแบบย่อ
collapse()Groupยุบกลุ่มนี้
expand()Groupขยายกลุ่มนี้
getControlIndex()Integerแสดงดัชนีเปิด/ปิดการควบคุมของกลุ่มนี้
getDepth()Integerแสดงผลความลึกของกลุ่มนี้
getRange()Rangeแสดงผลช่วงที่มีกลุ่มนี้
isCollapsed()Booleanแสดงผล true หากกลุ่มนี้ยุบ
remove()voidนำกลุ่มนี้ออกจากชีต ซึ่งจะลดความลึกของกลุ่ม range ลง ข้อแรก

เอกสารโดยละเอียด

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 ลง ข้อแรก การดำเนินการนี้อาจแก้ไขกลุ่มอื่นๆ หลังจากเรียกใช้ ออบเจ็กต์กลุ่มจะใช้ไม่ได้ 

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

ดูเพิ่มเติม