가능한 시작 및 끝 오프셋이 있는 Element
의 래퍼입니다. 이러한 오프셋을 사용하면 Text
요소 내 문자 범위를 검색결과, 문서 선택, 이름이 지정된 범위에 표시할 수 있습니다.
방법
메서드 | 반환 유형 | 간략한 설명 |
---|---|---|
getElement() | Element | 이 RangeElement 에 해당하는 Element 를 가져옵니다. |
getEndOffsetInclusive() | Integer | 범위 요소 내에서 부분 범위 끝의 위치를 가져옵니다. |
getStartOffset() | Integer | 범위 요소 내에서 부분 범위의 시작 위치를 가져옵니다. |
isPartial() | Boolean | 이 범위 요소가 전체 요소를 포함할지 아니면 요소 문자의 일부 선택만 포함할지 결정합니다. |
자세한 문서
getElement()
이 RangeElement
에 해당하는 Element
를 가져옵니다.
// Log debug information about a range element. Logger.log('Element type: ' + rangeElement.getElement().getType()); if (rangeElement.isPartial()) { Logger.log('The character range begins at ' + rangeElement.getStartOffset()); Logger.log('The character range ends at ' + rangeElement.getEndOffsetInclusive()); } else { Logger.log('The entire range element is included.'); }
리턴
Element
: 이 RangeElement
에 해당하는 요소
승인
이 방법을 사용하는 스크립트는 다음 범위 중 하나 이상을 승인해야 합니다.
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
getEndOffsetInclusive()
범위 요소 내에서 부분 범위 끝의 위치를 가져옵니다. 요소가 Text
요소이고 isPartial()
가 true
를 반환하는 경우 오프셋은 범위 내 마지막 문자 앞의 문자 수 (즉, 범위에서 마지막 문자의 색인)입니다. 그 외의 모든 경우에는 이 메서드가 -1
를 반환합니다.
리턴
Integer
: Text
요소의 경우 범위 내 마지막 문자 앞의 문자 수, 다른 요소의 경우 -1
승인
이 방법을 사용하는 스크립트는 다음 범위 중 하나 이상을 승인해야 합니다.
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
getStartOffset()
범위 요소 내에서 부분 범위의 시작 위치를 가져옵니다. 요소가 Text
요소이고 isPartial()
가 true
를 반환하는 경우 오프셋은 범위 시작 이전의 문자 수 (즉, 범위의 첫 번째 문자의 색인)입니다. 그 외의 모든 경우에는 이 메서드는 -1
를 반환합니다.
리턴
Integer
: Text
요소의 경우 범위 시작 앞의 문자 수, 다른 요소의 경우 -1
승인
이 방법을 사용하는 스크립트는 다음 범위 중 하나 이상을 승인해야 합니다.
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
isPartial()
이 범위 요소가 전체 요소를 포함할지 아니면 요소 문자의 일부 선택만 포함할지 결정합니다. 부분 범위 요소 범위의 시작과 끝은 각각 getStartOffset()
와 getEndOffsetInclusive()
를 사용하여 확인할 수 있습니다.
리턴
Boolean
: 요소가 부분적으로 포함된 경우 true
, 포함되지 않은 경우 false
승인
이 방법을 사용하는 스크립트는 다음 범위 중 하나 이상을 승인해야 합니다.
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents