활성 시트에서 현재 활성 선택 항목에 액세스합니다. 선택 항목은 사용자가 선택한 셀 집합입니다. 시트에서 강조표시되어 있으며 인접하지 않은 범위일 수 있습니다. 선택한 셀의 한 셀은 현재 셀입니다. 현재 셀은 더 진한 색 테두리를 추가하는 것을 볼 수 있습니다.
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