Class RangeBuilder

컬렉션을 사용해 정리하기 내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.
RangeBuilder

문서 요소에서 Range 객체를 구성하는 데 사용되는 빌더입니다.

// Change the user's selection to a range that includes every table in the document.
var doc = DocumentApp.getActiveDocument();
var rangeBuilder = doc.newRange();
var tables = doc.getBody().getTables();
for (var i = 0; i < tables.length; i++) {
  rangeBuilder.addElement(tables[i]);
}
doc.setSelection(rangeBuilder.build());

메서드

메서드반환 유형간략한 설명
addElement(element)RangeBuilder전체 Element를 이 RangeBuilder에 추가합니다.
addElement(textElement, startOffset, endOffsetInclusive)RangeBuilderRangeBuilder에 일부 Text 요소를 추가합니다.
addElementsBetween(startElement, endElementInclusive)RangeBuilder전체 요소 두 개와 그 사이의 모든 요소를 이 RangeBuilder에 추가합니다.
addElementsBetween(startTextElement, startOffset, endTextElementInclusive, endOffsetInclusive)RangeBuilder두 개의 부분 Text 요소와 그 사이의 모든 요소를 RangeBuilder에 추가합니다.
addRange(range)RangeBuilderRange에 다른 Range의 콘텐츠를 추가합니다.
build()Range빌더에 적용된 설정에서 Range를 구성합니다.
getRangeElements()RangeElement[]부분적인 Text 요소를 포함하여 이 Range의 모든 요소를 가져옵니다 (예: Text 요소의 일부만 포함하는 선택의 경우).

자세한 문서

addElement(element)

전체 Element를 이 RangeBuilder에 추가합니다.

매개변수

이름유형설명
elementElement추가할 요소

Return

RangeBuilder — 이 체이닝 도구

승인

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

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

addElement(textElement, startOffset, endOffsetInclusive)

RangeBuilder에 일부 Text 요소를 추가합니다.

매개변수

이름유형설명
textElementText부분적으로 추가될 텍스트 요소
startOffsetInteger포함할 첫 번째 문자 앞의 문자 수 (즉, 범위의 첫 번째 문자 색인)입니다.
endOffsetInclusiveInteger포함될 마지막 문자 앞 글자 수(범위에서 마지막 문자의 색인)

Return

RangeBuilder — 이 체이닝 도구

승인

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

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

addElementsBetween(startElement, endElementInclusive)

전체 요소 두 개와 그 사이의 모든 요소를 이 RangeBuilder에 추가합니다.

매개변수

이름유형설명
startElementElement추가할 첫 번째 요소
endElementInclusiveElement추가할 마지막 요소

Return

RangeBuilder — 이 체이닝 도구

승인

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

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

addElementsBetween(startTextElement, startOffset, endTextElementInclusive, endOffsetInclusive)

두 개의 부분 Text 요소와 그 사이의 모든 요소를 RangeBuilder에 추가합니다.

매개변수

이름유형설명
startTextElementText부분적으로 추가될 첫 번째 텍스트 요소
startOffsetIntegerstartTextElement의 첫 번째 문자 앞의 문자 수 (즉, 범위의 첫 번째 문자 색인)
endTextElementInclusiveText부분적으로 추가될 마지막 텍스트 요소
endOffsetInclusiveInteger포함할 endTextElementInclusive 문자의 마지막 문자 앞에 있는 문자의 수 (즉, 범위 내 마지막 문자의 색인)

Return

RangeBuilder — 이 체이닝 도구

승인

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

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

addRange(range)

Range에 다른 Range의 콘텐츠를 추가합니다.

매개변수

이름유형설명
rangeRange요소를 추가해야 하는 범위

Return

RangeBuilder — 이 체이닝 도구

승인

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

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

build()

빌더에 적용된 설정에서 Range를 구성합니다.

Return

Range: 새로 구성된 범위


getRangeElements()

부분적인 Text 요소를 포함하여 이 Range의 모든 요소를 가져옵니다 (예: Text 요소의 일부만 포함하는 선택의 경우). Text 요소가 범위에 일부만 포함되는지 확인하려면 RangeElement.isPartial()을 참고하세요.

Return

RangeElement[]: 문서에 표시되는 순서대로 요소의 배열입니다.

승인

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

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

지원 중단된 메서드