Class Group

Group

Truy cập và sửa đổi nhóm bảng tính. Nhóm là sự liên kết giữa một khoảng liền kề nhau hàng hoặc cột có thể mở rộng hoặc thu gọn dưới dạng một đơn vị để ẩn/hiển thị các hàng hoặc cột. Mỗi nhóm có một nút điều khiển bật/tắt trên hàng hoặc cột ngay trước hoặc sau nhóm (tuỳ thuộc vào chế độ cài đặt) có thể mở rộng hoặc thu gọn toàn bộ nhóm.

Chiều sâu của một nhóm thể hiện vị trí lồng nhau của nhóm và số lượng nhóm lớn hơn nhóm chứa nhóm đó. Trạng thái thu gọn của nhóm cho biết liệu nhóm phải ở trạng thái thu gọn hoặc mở rộng sau khi nhóm mẹ được mở rộng. Ngoài ra, tại khi một nhóm được thu gọn hoặc mở rộng, các hàng hoặc cột trong nhóm đó sẽ bị ẩn hoặc đặt ở chế độ hiển thị, mặc dù từng hàng hoặc cột riêng lẻ có thể bị ẩn hoặc đặt ở chế độ hiển thị bất kể trạng thái thu gọn.

Phương thức

Phương thứcLoại dữ liệu trả vềMô tả ngắn
collapse()GroupThu gọn nhóm này.
expand()GroupMở rộng nhóm này.
getControlIndex()IntegerTrả về chỉ mục điều khiển bật/tắt của nhóm này.
getDepth()IntegerTrả về độ sâu của nhóm này.
getRange()RangeTrả về dải ô mà nhóm này tồn tại.
isCollapsed()BooleanTrả về true nếu nhóm này được thu gọn.
remove()voidXoá nhóm này khỏi trang tính, giảm chiều sâu của nhóm của range xuống một.

Tài liệu chi tiết

collapse()

Thu gọn nhóm này. 

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();

Cầu thủ trả bóng

Group — nhóm này, để tạo chuỗi

Ủy quyền

Tập lệnh sử dụng phương thức này yêu cầu ủy quyền với một hoặc nhiều phạm vi sau:

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

expand()

Mở rộng nhóm này. 

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();

Cầu thủ trả bóng

Group — nhóm này, để tạo chuỗi

Ủy quyền

Tập lệnh sử dụng phương thức này yêu cầu ủy quyền với một hoặc nhiều phạm vi sau:

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

getControlIndex()

Trả về chỉ mục điều khiển bật/tắt của nhóm này. Đây là chỉ mục ngay trước dải ô khi nút điều khiển được hiển thị trước nhóm hoặc chỉ mục ngay sau dải ô. 

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();

Cầu thủ trả bóng

Integer — chỉ mục bật/tắt điều khiển của nhóm này

Ủy quyền

Tập lệnh sử dụng phương thức này yêu cầu ủy quyền với một hoặc nhiều phạm vi sau:

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

getDepth()

Trả về độ sâu của nhóm này. 

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();

Cầu thủ trả bóng

Integer — chiều sâu của nhóm này

Ủy quyền

Tập lệnh sử dụng phương thức này yêu cầu ủy quyền với một hoặc nhiều phạm vi sau:

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

getRange()

Trả về dải ô mà nhóm này tồn tại. 

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();

Cầu thủ trả bóng

Range – dải ô mà nhóm tồn tại

Ủy quyền

Tập lệnh sử dụng phương thức này yêu cầu ủy quyền với một hoặc nhiều phạm vi sau:

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

isCollapsed()

Trả về true nếu nhóm này được thu gọn. 

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();

Cầu thủ trả bóng

Boolean — true nếu nhóm này được thu gọn; sẽ trả về false nếu không

Ủy quyền

Tập lệnh sử dụng phương thức này yêu cầu ủy quyền với một hoặc nhiều phạm vi sau:

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

remove()

Xoá nhóm này khỏi trang tính, giảm chiều sâu của nhóm của range đi một. Thao tác này có thể sửa đổi các nhóm khác. Sau khi gọi lệnh này, đối tượng nhóm sẽ không còn hợp lệ để sử dụng. 

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();

Ủy quyền

Tập lệnh sử dụng phương thức này yêu cầu ủy quyền với một hoặc nhiều phạm vi sau:

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

Xem thêm