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를 반환하고, 그렇지 않으면 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

참고 항목