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[] - ドキュメントでの出現順の要素の配列

承認

このメソッドを使用するスクリプトには、次のスコープの 1 つ以上を使用した承認が必要です。

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

サポート終了のメソッド