Class Group

Group

Truy cập và sửa đổi các nhóm bảng tính. Nhóm là 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 các hàng hoặc cột. Mỗi nhóm đều 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.

Độ 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 đó sẽ vẫn ở trạng thái thu gọn hay mở rộng sau khi một nhóm mẹ được mở rộng. Ngoài ra, tại thời điểm một nhóm bị 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 đượ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ế độ kiểm soá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 bị thu gọn.
remove()voidXoá nhóm này khỏi trang tính, giảm độ 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. 

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 cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

  • 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 cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

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

getControlIndex()

Trả về chỉ mục bật/tắt chế độ kiểm soát 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 xuất hiện trước nhóm hoặc chỉ mục ngay sau dải ô trong trường hợp khác. 

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 cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

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

getDepth()

Trả về độ 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 cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

  • 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. 

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 mà nhóm tồn tại.

Ủy quyền

Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

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

isCollapsed()

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; nếu không thì trả về false.

Ủy quyền

Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

  • 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 đi 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 cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

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

Xem thêm