Class Range

범위

문서 내 요소의 범위입니다. 사용자의 선택은 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

지원 중단된 메서드