Class Selection

선택

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

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