스프레드시트 그룹에 액세스하고 수정합니다. 그룹은 행이나 열을 숨기거나 표시하기 위한 단위로 펼치거나 접을 수 있는 연속된 행 또는 열 간격 간의 연결입니다. 각 그룹의 경우 설정에 따라 그룹 전체를 펼치거나 접을 수 있는 컨트롤 전환이 그룹 바로 앞이나 뒤의 행이나 열에 있습니다.
그룹의 깊이는 그룹의 중첩된 위치와 그룹이 포함된 큰 그룹의 수를 나타냅니다. 그룹의 접힌 상태는 상위 그룹을 펼친 후에 그룹을 접힌 상태로 유지해야 하는지 아니면 펼쳐진 상태를 유지해야 하는지를 나타냅니다. 또한 그룹이 축소되거나 펼쳐질 때 그룹 내 행 또는 열이 숨겨지거나 표시되도록 설정되지만, 축소된 상태와 관계없이 개별 행 또는 열을 숨기거나 표시하도록 설정할 수 있습니다.
방법
메서드 | 반환 유형 | 간략한 설명 |
---|---|---|
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