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

已淘汰的方法