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ức | Kiểu dữ liệu trả về | Mô tả ngắn |
---|---|---|
collapse() | Group | Thu gọn nhóm này. |
expand() | Group | Mở rộng nhóm này. |
getControlIndex() | Integer | Trả về chỉ mục bật/tắt chế độ điều khiển của nhóm này. |
getDepth() | Integer | Trả về chiều sâu của nhóm này. |
getRange() | Range | Trả về dải ô mà tại đó nhóm này tồn tại. |
isCollapsed() | Boolean | Trả về true nếu nhóm này được thu gọn. |
remove() | void | Xoá 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
Boolean
– true
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