Class Group

Group

Truy cập và sửa đổi nhóm bảng tính. Nhóm là mối liên kết giữa một khoảng thời gian giữa các hàng hoặc cột liền kề mà có thể mở rộng hoặc thu gọn thành một đơn vị để ẩn/hiện các hàng hoặc cột. Mỗi nhóm có một nút bật/tắt kiểm soá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 là vị trí lồng nhau của nhóm đó và số lượng nhóm lớn hơn chứa nhóm đó. Trạng thái thu gọn của nhóm đề cập đến việc nhóm đó nên tiếp tục được thu gọn hay mở rộng sau khi nhóm mẹ được mở rộng. Ngoài ra, tại thời điểm 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 được đặt ở chế độ hiển thị, mặc dù các 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ứcKiểu 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 bật/tắt chế độ điều khiển của nhóm này.
getDepth()IntegerTrả về chiều sâu của nhóm này.
getRange()RangeTrả về dải ô mà tại đó 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 nhóm của range đi 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 cần được uỷ 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 cần được uỷ 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 bật/tắt chế độ điều khiển của nhóm này. Đây là chỉ mục ngay trước dải ô khi nút bật/tắt chế độ điều khiển 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 chế độ kiểm soát của nhóm này

Ủy quyền

Tập lệnh sử dụng phương thức này cần được uỷ 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ề chiều 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 cần được uỷ 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à tại đó 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 cần được uỷ 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

Booleantrue nếu nhóm này bị thu gọn; nếu không sẽ trả về false

Ủy quyền

Tập lệnh sử dụng phương thức này cần được uỷ 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 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 sử dụng được.

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 cần được uỷ 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