ドキュメント内の要素の範囲。ユーザーの選択は、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); } } } }
Methods
メソッド | 戻り値の型 | 概要 |
---|---|---|
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