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

已淘汰的方法