Class RangeElement

RangeElement

가능한 시작 및 끝 오프셋이 있는 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