나중에 가져올 수 있는 이름과 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() | String | 이 NamedRange 의 ID를 가져옵니다. |
getName() | String | 이 NamedRange 의 이름을 가져옵니다. |
getRange() | Range | 이 NamedRange 와 연결된 요소의 범위를 가져옵니다. |
remove() | void | 문서에서 이 NamedRange 를 삭제합니다. |
자세한 문서
getId()
이 NamedRange
의 ID를 가져옵니다. ID는 문서 내에서 고유합니다.
리턴
String
- 문서 내에서 고유한 범위의 ID
getName()
이 NamedRange
의 이름을 가져옵니다. 이름은 반드시 고유하지는 않습니다.
리턴
String
- 범위의 이름(반드시 고유하지는 않음)
승인
이 방법을 사용하는 스크립트는 다음 범위 중 하나 이상을 승인해야 합니다.
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
getRange()
remove()
문서에서 이 NamedRange
를 삭제합니다. 이 메서드는 범위의 콘텐츠를 삭제하지 않으며 참조만 삭제합니다. 이미 삭제된 NamedRange
에서 이 메서드를 호출하면 아무 효과가 없습니다.
승인
이 방법을 사용하는 스크립트는 다음 범위 중 하나 이상을 승인해야 합니다.
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents