활성 시트에서 현재 활성 선택 항목에 액세스합니다. 선택 항목은 사용자가 시트에서 강조 표시한 셀 집합이며 인접하지 않은 범위일 수 있습니다. 선택 항목 중 하나의 셀은 사용자의 현재 포커스가 있는 현재 셀입니다. Google Sheets UI에서 현재 셀은 더 어두운 테두리로 강조표시됩니다.
var activeSheet = SpreadsheetApp.getActiveSheet(); var rangeList = activeSheet.getRangeList(['A1:B4', 'D1:E4']); rangeList.activate(); var selection = activeSheet.getSelection(); // Current Cell: D1 console.log('Current Cell: ' + selection.getCurrentCell().getA1Notation()); // Active Range: D1:E4 console.log('Active Range: ' + selection.getActiveRange().getA1Notation()); // Active Ranges: A1:B4, D1:E4 var ranges = selection.getActiveRangeList().getRanges(); for (var i = 0; i < ranges.length; i++) { console.log('Active Ranges: ' + ranges[i].getA1Notation()); } console.log('Active Sheet: ' + selection.getActiveSheet().getName());
방법
메서드 | 반환 유형 | 간략한 설명 |
---|---|---|
getActiveRange() | Range | 활성 시트에서 선택된 범위를 반환하거나 활성 범위가 없는 경우 null 을 반환합니다. |
getActiveRangeList() | RangeList | 활성 시트의 활성 범위 목록을 반환하거나 활성 범위가 없는 경우 null 을 반환합니다. |
getActiveSheet() | Sheet | 스프레드시트의 활성 시트를 반환합니다. |
getCurrentCell() | Range | 활성 범위 중 하나에서 선택된 현재 (강조표시된) 셀을 반환하거나 현재 셀이 없는 경우 null 을 반환합니다. |
getNextDataRange(direction) | Range | current cell 과 active range 에서 시작하여 지정된 방향으로 이동하면, 현재 셀을 커버하는 동시에 next data cell 을 포함하도록 범위의 적절한 가장자리가 이동된 조정된 범위를 반환합니다. |
자세한 문서
getActiveRange()
활성 시트에서 선택된 범위를 반환하거나 활성 범위가 없는 경우 null
을 반환합니다. 여러 범위가 선택된 경우 이 메서드는 마지막으로 선택한 범위만 반환합니다.
var selection = SpreadsheetApp.getActiveSpreadsheet().getSelection(); var activeRange = selection.getActiveRange();
리턴
Range
- 활성 범위입니다.
승인
이 방법을 사용하는 스크립트는 다음 범위 중 하나 이상을 승인해야 합니다.
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getActiveRangeList()
활성 시트의 활성 범위 목록을 반환하거나 활성 범위가 없는 경우 null
을 반환합니다.
단일 범위를 선택한 경우 getActiveRange()
호출처럼 작동합니다.
var sheet = SpreadsheetApp.getActiveSheet(); // Returns the list of active ranges. var activeRangeList = sheet.getActiveRangeList();
리턴
RangeList
- 활성 범위 목록입니다.
승인
이 방법을 사용하는 스크립트는 다음 범위 중 하나 이상을 승인해야 합니다.
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getActiveSheet()
스프레드시트의 활성 시트를 반환합니다.
var selection = SpreadsheetApp.getActiveSpreadsheet().getSelection(); var activeSheet = selection.getActiveSheet();
리턴
Sheet
- 스프레드시트의 활성 시트입니다.
승인
이 방법을 사용하는 스크립트는 다음 범위 중 하나 이상을 승인해야 합니다.
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getCurrentCell()
활성 범위 중 하나에서 선택된 현재 (강조표시된) 셀을 반환하거나 현재 셀이 없는 경우 null
을 반환합니다.
var selection = SpreadsheetApp.getActiveSpreadsheet().getSelection(); // Returns the current highlighted cell in the one of the active ranges. var currentCell = selection.getCurrentCell();
리턴
Range
- 현재 셀입니다.
승인
이 방법을 사용하는 스크립트는 다음 범위 중 하나 이상을 승인해야 합니다.
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getNextDataRange(direction)
current cell
과 active range
에서 시작하여 지정된 방향으로 이동하면, 현재 셀을 커버하는 동시에 next data cell
을 포함하도록 범위의 적절한 가장자리가 이동된 조정된 범위를 반환합니다. 활성 범위가 방향의 dimension
을 따라 제한되지 않으면 원래의 활성 범위가 반환됩니다. 현재 셀 또는 활성 범위가 없으면 null
이 반환됩니다. 이는 편집기에서 범위를 선택하고 Ctrl+Shift+[arrow key]
를 누르는 것과 같습니다.
// Assume the active spreadsheet is blank. var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // Makes C3 the current cell and C3:E5 the active range. sheet.getRange('C3:E5').activate(); // Logs 'C1:E3' console.log(SpreadsheetApp.getSelection() .getNextDataRange(SpreadsheetApp.Direction.UP) .getA1Notation());
매개변수
이름 | 유형 | 설명 |
---|---|---|
direction | Direction | 다음 데이터 영역 에지 셀을 찾을 방향입니다. |
리턴
Range
- 데이터 셀이 포함된 조정된 범위 또는 선택 항목이 없는 경우 null
입니다.
승인
이 방법을 사용하는 스크립트는 다음 범위 중 하나 이상을 승인해야 합니다.
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets