Class Group

Group

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ứcLoại 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 đ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 ô chứa nhóm này.
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 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

getControlIndex()

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

getDepth()

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

getRange()

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

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; 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

Xem thêm