Class RangeElement

범위요소

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

메서드

메서드반환 유형간략한 설명
getElement()Element이 RangeElement에 해당하는 Element를 가져옵니다.
getEndOffsetInclusive()Integer범위 요소 내에서 부분 범위의 끝 위치를 가져옵니다.
getStartOffset()Integer범위 요소 내에서 부분 범위의 시작 위치를 가져옵니다.
isPartial()Boolean이 범위 요소가 전체 요소를 포함하는지 아니면 요소의 문자 중 일부만 선택하는지 결정합니다.

자세한 문서

getElement()

이 RangeElement에 해당하는 Element를 가져옵니다. 

const rangeElement = DocumentApp.getActiveDocument().getSelection().getRangeElements()[0];

// 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