Class NamedRange

컬렉션을 사용해 정리하기 내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.
이름 지정 범위

나중에 검색할 수 있도록 이름과 ID가 있는 Range 이름은 반드시 고유하지는 않습니다. HTML의 클래스와 마찬가지로 같은 문서의 서로 다른 여러 범위가 동일한 이름을 공유할 수 있습니다. 이와 달리 ID는 문서 내에서 고유합니다(예: HTML의 ID). NamedRange가 문서에 추가되면 수정할 수 없고 삭제만 합니다.

NamedRange에는 문서에 액세스하는 모든 스크립트에 액세스할 수 있습니다. 스크립트 간의 의도하지 않은 충돌을 방지하려면 고유한 문자열을 범위 이름에 접두사로 추가하는 것이 좋습니다.

// Create a named range that includes every table in the document.
var doc = DocumentApp.getActiveDocument();
var rangeBuilder = doc.newRange();
var tables = doc.getBody().getTables();
for (var i = 0; i < tables.length; i++) {
  rangeBuilder.addElement(tables[i]);
}
doc.addNamedRange('myUniquePrefix-tables', rangeBuilder.build());

메서드

메서드반환 유형간략한 설명
getId()StringNamedRange의 ID를 가져옵니다.
getName()StringNamedRange의 이름을 가져옵니다.
getRange()RangeNamedRange에 연결된 요소의 범위를 가져옵니다.
remove()void문서에서 이 NamedRange를 삭제합니다.

자세한 문서

getId()

NamedRange의 ID를 가져옵니다. ID는 문서 내에서 고유합니다.

Return

String: 문서 내에서 고유한 범위 ID입니다.


getName()

NamedRange의 이름을 가져옵니다. 이름은 고유하지 않을 수 있습니다.

Return

String: 범위 이름(반드시 고유하지는 않음)

승인

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

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

getRange()

NamedRange에 연결된 요소의 범위를 가져옵니다.

Return

Range: 이름 및 ID와 연결된 요소의 범위

승인

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

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

remove()

문서에서 이 NamedRange를 삭제합니다. 이 메서드는 범위의 콘텐츠를 삭제하지 않으며 참조만 삭제합니다. 이미 삭제된 NamedRange에서 이 메서드를 호출해도 효과가 없습니다.

승인

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

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