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)RangeBuilderRangeBuilder에 전체 Element를 추가합니다.
addElement(textElement, startOffset, endOffsetInclusive)RangeBuilderRangeBuilder에 일부 Text 요소를 추가합니다.
addElementsBetween(startElement, endElementInclusive)RangeBuilderRangeBuilder에 전체 요소 두 개와 이 요소 사이의 모든 요소를 추가합니다.
addElementsBetween(startTextElement, startOffset, endTextElementInclusive, endOffsetInclusive)RangeBuilder부분 Text 요소 두 개와 이 요소 사이의 모든 요소를 RangeBuilder에 추가합니다.
addRange(range)RangeBuilder다른 Range의 콘텐츠를 이 RangeBuilder에 추가합니다.
build()Range빌더에 적용된 설정에서 Range를 구성합니다.
getRangeElements()RangeElement[]부분 Text 요소를 포함하여 이 Range의 모든 요소를 가져옵니다 (예: Text 요소의 일부만 포함하는 선택 항목의 경우).

자세한 문서

addElement(element)

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

매개변수

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

리턴

RangeBuilder: 체이닝을 위한 빌더입니다.

승인

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

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

addElement(textElement, startOffset, endOffsetInclusive)

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

매개변수

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

리턴

RangeBuilder: 체이닝을 위한 빌더입니다.

승인

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

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

addElementsBetween(startElement, endElementInclusive)

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

매개변수

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

리턴

RangeBuilder: 체이닝을 위한 빌더입니다.

승인

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

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

addElementsBetween(startTextElement, startOffset, endTextElementInclusive, endOffsetInclusive)

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

매개변수

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

리턴

RangeBuilder: 체이닝을 위한 빌더입니다.

승인

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

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

addRange(range)

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

매개변수

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

리턴

RangeBuilder: 체이닝을 위한 빌더입니다.

승인

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

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

build()

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

리턴

Range - 새로 구성된 범위


getRangeElements()

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

리턴

RangeElement[]: 문서에 표시되는 순서대로 된 요소의 배열

승인

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

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

지원 중단된 메서드