문서에 있는 요소의 범위입니다. 사용자의 선택은 다른 용도 중에서 Range
로 표현됩니다. 스크립트는 스크립트를 실행하는 사용자가 선택한 사용자에게만 액세스할 수 있으며, 스크립트가 문서에 결합된 경우에만 액세스할 수 있습니다.
// Bold all selected text. var selection = DocumentApp.getActiveDocument().getSelection(); if (selection) { var elements = selection.getRangeElements(); for (var i = 0; i < elements.length; i++) { var element = elements[i]; // Only modify elements that can be edited as text; skip images and other non-text elements. if (element.getElement().editAsText) { var text = element.getElement().editAsText(); // Bold the selected part of the element, or the full element if it's completely selected. if (element.isPartial()) { text.setBold(element.getStartOffset(), element.getEndOffsetInclusive(), true); } else { text.setBold(true); } } } }
방법
메서드 | 반환 유형 | 간략한 설명 |
---|---|---|
getRangeElements() | RangeElement[] | 부분 Text 요소를 포함하여 이 Range 의 모든 요소를 가져옵니다 (예: Text 요소의 일부만 포함하는 선택 항목의 경우). |
자세한 문서
getRangeElements()
부분 Text
요소를 포함하여 이 Range
의 모든 요소를 가져옵니다 (예: Text
요소의 일부만 포함하는 선택 항목의 경우). Text
요소가 범위에 부분적으로만 포함되어 있는지 확인하려면 RangeElement.isPartial()
를 참고하세요.
리턴
RangeElement[]
: 문서에 표시되는 순서대로 된 요소의 배열
승인
이 방법을 사용하는 스크립트는 다음 범위 중 하나 이상을 승인해야 합니다.
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents