Class Selection

선택

활성 시트의 현재 활성 선택 항목에 액세스합니다. 선택 항목은 사용자가 시트에서 강조표시한 셀 집합입니다. 인접하지 않은 범위일 수 있습니다. 선택된 셀 중 하나는 사용자의 현재 포커스가 있는 현재 셀입니다. 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)Rangecurrent 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());

매개변수

이름유형설명
directionDirection다음 데이터 영역 에지 셀을 찾을 방향입니다.

리턴

Range: 데이터 셀이 포함된 조정 범위 또는 선택 항목이 없는 경우 null입니다.

승인

이 방법을 사용하는 스크립트에는 다음 범위 중 하나 이상을 사용하여 승인이 필요합니다.

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets