Class RangeBuilder

RangeBuilder

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

// Change the user's selection to a range that includes every table in the active tab.
var doc = DocumentApp.getActiveDocument();
var documentTab = doc.getActiveTab().asDocumentTab();
var rangeBuilder = documentTab.newRange();
var tables = documentTab.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)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)

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

매개변수

이름유형설명
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

지원 중단된 메서드