Class Group

그룹

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

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

메서드

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

자세한 문서

collapse()

이 그룹을 접습니다. 

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

리턴

Group — 이 그룹(연결용)

승인

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

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

expand()

이 그룹을 펼칩니다. 

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

리턴

Group — 이 그룹(연결용)

승인

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

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

getControlIndex()

이 그룹의 제어 전환 색인을 반환합니다. 제어 전환이 그룹 앞에 표시되는 경우 범위 바로 앞의 색인이고, 그렇지 않은 경우 범위 바로 뒤의 색인입니다. 

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

리턴

Integer — 이 그룹의 제어 전환 색인입니다.

승인

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

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

getDepth()

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

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

리턴

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

승인

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

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

getRange()

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

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

리턴

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

승인

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

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

isCollapsed()

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

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

리턴

Boolean — true 이 그룹이 접혀 있으면 true를 반환하고, 그렇지 않으면 false를 반환합니다.

승인

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

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

remove()

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

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

승인

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

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

참고 항목