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

內容詳盡的說明文件

getRangeElements()

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

回攻員

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

授權

使用這個方法的指令碼需要下列一或多個範圍的授權：

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

已淘汰的方法