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

참고 항목