Class RangeElement

범위 요소

시작 및 끝 오프셋이 가능한 Element 래퍼 이 오프셋을 사용하면 Text 요소 내의 범위를 검색결과, 문서 선택, 이름이 지정된 범위에 표시할 수 있습니다.

메서드

메서드반환 유형간략한 설명
getElement()ElementRangeElement에 해당하는 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.');
}

Return

Element: 이 RangeElement에 해당하는 요소입니다.

승인

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

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

getEndOffsetInclusive()

범위 요소 내 부분 범위의 끝 위치를 가져옵니다. 요소가 Text 요소이고 isPartial()true를 반환하면 오프셋은 범위의 마지막 문자 앞 문자 수 (즉, 범위의 마지막 문자 색인)입니다. 그 외의 경우 이 메서드는 -1를 반환합니다.

Return

IntegerText 요소의 경우 범위의 마지막 문자 앞의 문자 수, 다른 요소의 경우 -1

승인

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

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

getStartOffset()

범위 요소 내 부분 범위의 시작 위치를 가져옵니다. 요소가 Text 요소이고 isPartial()true를 반환하면 오프셋은 범위 시작 전 문자 수 (즉, 범위의 첫 번째 문자 색인)입니다. 그 외의 경우 이 메서드는 -1를 반환합니다.

Return

IntegerText 요소의 경우 범위 시작 전 문자 수, 다른 요소의 경우 -1

승인

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

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

isPartial()

이 범위 요소가 전체 요소를 포함하는지 아니면 요소의 일부분을 선택할지 결정합니다. 부분 범위 요소의 범위 시작과 끝은 각각 getStartOffset()getEndOffsetInclusive()를 사용하여 확인할 수 있습니다.

Return

Boolean: 요소가 부분적으로 포함된 경우 true, 포함되지 않은 경우 false

승인

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

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