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ức | Loại 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 điều khiển bật/tắt của nhóm này. |
getDepth() | Integer | Trả về độ sâu của nhóm này. |
getRange() | Range | Trả về dải ô mà 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 của 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 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