Truy cập và sửa đổi các nhóm bảng tính. Nhóm là một mối liên kết giữa một khoảng thời gian của các hàng hoặc cột liền kề có thể được 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 bật/tắt điều khiển 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 đề cập đến 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 một nhóm đề cập đến việc nhóm đó có nên vẫn ở trạng thái 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 thành hiển thị, mặc dù các hàng hoặc cột riêng lẻ có thể bị ẩn hoặc được đặt thành 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. |
get | Integer | Trả về chỉ mục bật/tắt điều khiển của nhóm này. |
get | Integer | Trả về chiều sâu của nhóm này. |
get | Range | Trả về dải ô chứa nhóm này. |
is | Boolean | Trả về true nếu nhóm này bị thu gọn. |
remove() | void | Xoá nhóm này khỏi trang tính, giảm độ sâu nhóm của range xuống một. |
Tài liệu chi tiết
collapse()
Thu gọn nhóm này.
const sheet = SpreadsheetApp.getActiveSpreadsheet().getSheets()[0];
const range = sheet.getRange('2:3');
range.shiftRowGroupDepth(1);
const 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
Các tập lệnh sử dụng phương thức này yêu cầu đượ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.
const sheet = SpreadsheetApp.getActiveSpreadsheet().getSheets()[0];
const range = sheet.getRange('2:3');
range.shiftRowGroupDepth(1);
const 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
Các tập lệnh sử dụng phương thức này yêu cầu đượ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
get
Trả về chỉ mục bật/tắt đ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 điều khiển hiển thị trước nhóm hoặc chỉ mục ngay sau dải ô nếu không.
const sheet = SpreadsheetApp.getActiveSpreadsheet().getSheets()[0];
sheet.setRowGroupControlAfter(true);
const range = sheet.getRange('2:3');
range.shiftRowGroupDepth(1);
const group = sheet.getRowGroup(2, 1);
// Returns 4
const controlIndex = group.getControlIndex();
Cầu thủ trả bóng
Integer – chỉ mục nút bật/tắt điều khiển của nhóm này
Ủy quyền
Các tập lệnh sử dụng phương thức này yêu cầu đượ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
get
Trả về chiều sâu của nhóm này.
const sheet = SpreadsheetApp.getActiveSpreadsheet().getSheets()[0];
const range = sheet.getRange('2:3');
range.shiftRowGroupDepth(1);
const group = sheet.getRowGroup(2, 1);
// Returns 1 if the group is at depth 1.
const depth = group.getDepth();
Cầu thủ trả bóng
Integer – độ sâu của nhóm này
Ủy quyền
Các tập lệnh sử dụng phương thức này yêu cầu đượ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
get
Trả về dải ô chứa nhóm này.
const sheet = SpreadsheetApp.getActiveSpreadsheet().getSheets()[0];
let range = sheet.getRange('2:3');
range.shiftRowGroupDepth(1);
const 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 – phạm vi tồn tại của nhóm
Ủy quyền
Các tập lệnh sử dụng phương thức này yêu cầu đượ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
is
Trả về true nếu nhóm này bị thu gọn.
const sheet = SpreadsheetApp.getActiveSpreadsheet().getSheets()[0];
const range = sheet.getRange('2:3');
range.shiftRowGroupDepth(1);
const group = sheet.getRowGroup(2, 1);
// Returns true if the group is collapsed.
const isCollapsed = group.isCollapsed();
Cầu thủ trả bóng
Boolean – true nếu nhóm này bị thu gọn; trả về false nếu không
Ủy quyền
Các tập lệnh sử dụng phương thức này yêu cầu đượ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 độ sâu nhóm của range xuống một. Thao tác này có thể sửa đổi các nhóm khác. Sau khi gọi phương thức này, đối tượng nhóm sẽ không hợp lệ để sử dụng.
const sheet = SpreadsheetApp.getActiveSpreadsheet().getSheets()[0];
let range = sheet.getRange('2:3');
range.shiftRowGroupDepth(1);
const group = sheet.getRowGroup(2, 1);
// Removes this group
range = group.remove();
Ủy quyền
Các tập lệnh sử dụng phương thức này yêu cầu đượ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