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[]取得此 Range 中的所有元素，包括任何部分 Text 元素 (例如，如果選取範圍只包含 Text 元素的一部分)。

內容詳盡的說明文件

getRangeElements()

會取得這個 Range 中的所有元素，包括任何部分 Text 元素 (例如，如果選取範圍只包含 Text 元素的一部分)。如要判斷 Text 元素是否只包含範圍內的部分內容，請參閱 RangeElement.isPartial()。

回攻員

RangeElement[]：元素陣列，按照元素在文件中顯示的順序

授權

使用這個方法的腳本需要具備下列一或多個範圍的授權：

  • https://www.googleapis.com/auth/documents.currentonly
  • https://www.googleapis.com/auth/documents

已淘汰的方法