Class RangeBuilder

범위빌더

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

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

메서드

메서드반환 유형간략한 설명
addElement(element)RangeBuilder이 RangeBuilder에 전체 Element를 추가합니다.
addElement(textElement, startOffset, endOffsetInclusive)RangeBuilder이 RangeBuilder에 부분 Text 요소를 추가합니다.
addElementsBetween(startElement, endElementInclusive)RangeBuilder두 개의 전체 요소와 그 사이의 모든 요소를 이 RangeBuilder에 추가합니다.
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

지원 중단된 메서드