Class Group

그룹

스프레드시트 그룹 액세스 및 수정 그룹은 연속된 간격과 행 또는 열을 숨기거나 표시하기 위해 단위로 펼치거나 접을 수 있는 행 또는 열입니다. 각 그룹의 행 또는 열에 그룹 바로 앞이나 뒤에 컨트롤 전환 버튼이 있습니다. (설정에 따라) 그룹 전체를 펼치거나 접을 수 있습니다.

그룹의 깊이는 그룹의 중첩된 위치와 그룹에는 그룹이 포함됩니다. 그룹의 접힌 상태는 그룹이 상위 그룹을 펼친 후에도 접힌 상태 또는 펼친 상태를 유지해야 합니다. 또한 그룹을 접거나 펼칠 때 그룹 내의 행 또는 열이 숨겨지거나 는 표시되도록 설정할 수 있지만 개별 행 또는 열은 축소 상태입니다.

메서드

메서드반환 유형간략한 설명
collapse()Group이 그룹을 접습니다.
expand()Group이 그룹을 펼칩니다.
getControlIndex()Integer이 그룹의 컨트롤 토글 색인을 반환합니다.
getDepth()Integer이 그룹의 깊이를 반환합니다.
getRange()Range이 그룹이 존재하는 범위를 반환합니다.
isCollapsed()Boolean이 그룹이 접혀 있으면 true를 반환합니다.
remove()void시트에서 이 그룹을 삭제하여 range의 그룹 깊이를 있습니다

자세한 문서

collapse()

이 그룹을 접습니다. 

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

리턴

Group: 이 그룹(체이닝용)

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.

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

expand()

이 그룹을 펼칩니다. 

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

리턴

Group: 이 그룹(체이닝용)

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.

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

getControlIndex()

이 그룹의 컨트롤 토글 색인을 반환합니다. 이것은 컨트롤 토글은 그룹 앞에 표시되고 그렇지 않으면 범위 바로 뒤에 색인이 표시됩니다. 

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

리턴

Integer: 이 그룹의 제어 전환 색인

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.

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

getDepth()

이 그룹의 깊이를 반환합니다. 

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

리턴

Integer: 이 그룹의 깊이입니다.

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.

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

getRange()

이 그룹이 존재하는 범위를 반환합니다. 

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

리턴

Range: 그룹이 존재하는 범위입니다.

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.

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

isCollapsed()

이 그룹이 접혀 있으면 true를 반환합니다. 

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

리턴

Boolean: 이 그룹이 접혀 있으면 true이고 그렇지 않으면 false을 반환합니다.

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.

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

remove()

시트에서 이 그룹을 삭제하여 range의 그룹 깊이를 있습니다 이로 인해 다른 그룹이 수정될 수도 있습니다. 이 메서드를 호출하면 그룹 객체를 사용할 수 없게 됩니다. 

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

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.

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

참고 항목