Class NamedRange

NamedRange

스프레드시트에서 이름이 지정된 범위를 만들고, 액세스하고, 수정합니다. 이름이 지정된 범위는 연결된 문자열 별칭이 있는 범위입니다. 데이터 > 이름이 지정된 범위... 메뉴의 Sheets UI를 통해 볼 수 있고 수정할 수 있습니다.

메서드

메서드반환 유형간략한 설명
getName()String이 이름이 지정된 범위의 이름을 가져옵니다.
getRange()Range이 이름이 지정된 범위에서 참조하는 범위를 가져옵니다.
remove()void이름이 지정된 범위를 삭제합니다.
setName(name)NamedRange이름이 지정된 범위의 이름을 설정하거나 업데이트합니다.
setRange(range)NamedRange이 이름이 지정된 범위의 범위를 설정하거나 업데이트합니다.

자세한 문서

getName()

이 이름이 지정된 범위의 이름을 가져옵니다.

리턴

String - 이 명명된 범위의 이름

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상의 승인이 필요합니다.

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

getRange()

이 이름이 지정된 범위에서 참조하는 범위를 가져옵니다.

리턴

Range - 이 명명된 범위와 연결된 스프레드시트 범위

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상의 승인이 필요합니다.

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

remove()

이름이 지정된 범위를 삭제합니다. 

// The code below deletes all the named ranges in the spreadsheet.
const namedRanges = SpreadsheetApp.getActive().getNamedRanges();
for (let i = 0; i < namedRanges.length; i++) {
  namedRanges[i].remove();
}

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상의 승인이 필요합니다.

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

setName(name)

이름이 지정된 범위의 이름을 설정하거나 업데이트합니다. 

// The code below updates the name for the first named range.
const namedRanges = SpreadsheetApp.getActiveSpreadsheet().getNamedRanges();
if (namedRanges.length > 1) {
  namedRanges[0].setName('UpdatedNamedRange');
}

매개변수

이름유형설명
nameString이름이 지정된 범위의 새 이름입니다.

리턴

NamedRange - 호출에 의해 이름이 설정된 범위

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상의 승인이 필요합니다.

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

setRange(range)

이 이름이 지정된 범위의 범위를 설정하거나 업데이트합니다.

매개변수

이름유형설명
rangeRange이 명명된 범위와 연결할 스프레드시트 범위입니다.

리턴

NamedRange - 스프레드시트 범위가 설정된 이름이 지정된 범위

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상의 승인이 필요합니다.

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