문서 요소에서 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 | 이 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
를 추가합니다.
매개변수
이름 | 유형 | 설명 |
---|---|---|
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()
getRangeElements()
부분 Text
요소를 포함하여 이 Range
의 모든 요소를 가져옵니다 (예: Text
요소의 일부만 포함하는 선택 항목의 경우). Text
요소가 범위에 부분적으로만 포함되어 있는지 확인하려면 RangeElement.isPartial()
를 참고하세요.
리턴
RangeElement[]
: 문서에 표시되는 순서대로 된 요소의 배열
승인
이 방법을 사용하는 스크립트는 다음 범위 중 하나 이상을 승인해야 합니다.
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents