Class Group

그룹

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

그룹의 깊이는 그룹의 중첩된 위치와 그룹이 포함된 큰 그룹의 수를 나타냅니다. 그룹의 접힌 상태는 상위 그룹을 펼친 후에 그룹을 접힌 상태로 유지해야 하는지 아니면 펼쳐진 상태를 유지해야 하는지를 나타냅니다. 또한 그룹이 축소되거나 펼쳐질 때 그룹 내 행 또는 열이 숨겨지거나 표시되도록 설정되지만, 축소된 상태와 관계없이 개별 행 또는 열을 숨기거나 표시하도록 설정할 수 있습니다.

방법

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

자세한 문서

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의 그룹 깊이를 1만큼 줄입니다. 다른 그룹이 수정될 수도 있습니다. 이 메서드를 호출하면 그룹 객체는 사용할 수 없게 됩니다.

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

참고 항목