Class RangeElement

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.');
}

리턴

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