Class Range

범위

문서의 요소 범위입니다. 사용자의 선택은 다른 용도 중에서도 Range로 표시됩니다. 스크립트는 스크립트를 실행하는 사용자의 선택에만 액세스할 수 있으며, 스크립트가 문서에 바인딩된 경우에만 액세스할 수 있습니다.

// Bold all selected text.
const selection = DocumentApp.getActiveDocument().getSelection();
if (selection) {
  const elements = selection.getRangeElements();
  for (let i = 0; i < elements.length; i++) {
    const element = elements[i];

    // Only modify elements that can be edited as text; skip images and other
    // non-text elements.
    if (element.getElement().editAsText) {
      const 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 요소의 일부만 포함된 선택의 경우).

지원 중단된 메서드

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

자세한 문서

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