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 요소의 일부만 포함된 선택의 경우).

지원 중단된 메서드

메서드	반환 유형	간략한 설명
getSelectedElements()	RangeElement[]	부분적으로 선택된 Text 요소를 포함하여 사용자가 문서의 열린 인스턴스에서 선택한 모든 요소를 가져옵니다.

자세한 문서

addElement(element)

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

매개변수

이름	유형	설명
element	Element	추가할 요소

리턴

RangeBuilder: 체이닝을 위한 이 빌더

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상의 승인이 필요합니다.

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

---

addElement(textElement, startOffset, endOffsetInclusive)

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

매개변수

이름	유형	설명
textElement	Text	부분적으로 추가할 텍스트 요소
startOffset	Integer	포함할 첫 번째 문자 앞의 문자 수 (즉, 범위의 첫 번째 문자 색인)
endOffsetInclusive	Integer	포함할 마지막 문자 앞의 문자 수(즉, 범위의 마지막 문자 색인)

리턴

RangeBuilder: 체이닝을 위한 이 빌더

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상의 승인이 필요합니다.

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

---

addElementsBetween(startElement, endElementInclusive)

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

매개변수

이름	유형	설명
startElement	Element	추가할 첫 번째 요소
endElementInclusive	Element	추가할 마지막 요소

리턴

RangeBuilder: 체이닝을 위한 이 빌더

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상의 승인이 필요합니다.

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

---

addElementsBetween(startTextElement, startOffset, endTextElementInclusive, endOffsetInclusive)

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

매개변수

이름	유형	설명
startTextElement	Text	부분적으로 추가된 첫 번째 텍스트 요소
startOffset	Integer	포함할 startTextElement의 첫 번째 문자 앞의 문자 수 (즉, 범위의 첫 번째 문자의 색인)
endTextElementInclusive	Text	부분적으로 추가된 마지막 텍스트 요소
endOffsetInclusive	Integer	포함할 endTextElementInclusive의 마지막 문자 앞의 문자 수 (즉, 범위의 마지막 문자 색인)

리턴

RangeBuilder: 체이닝을 위한 이 빌더

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상의 승인이 필요합니다.

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

---

addRange(range)

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

매개변수

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

리턴

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

지원 중단된 메서드

getSelectedElements()

지원 중단되었습니다. getRangeElements()로 이름을 바꿨습니다.

부분적으로 선택된 Text 요소를 포함하여 사용자가 문서의 열린 인스턴스에서 선택한 모든 요소를 가져옵니다.

리턴

RangeElement[]: 선택되거나 부분적으로 선택된 요소의 배열로, 문서에 표시되는 순서입니다.

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상의 승인이 필요합니다.

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