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

지원 중단된 메서드