Class Range
Stay organized with collections
Save and categorize content based on your preferences.
AI-generated Key Takeaways
-
A
Rangerepresents a range of elements in a Google Doc, often used to represent the user's selection. -
Scripts can only access the selection of the user who is running them within the bound document.
-
The
getRangeElements()method retrieves all elements within the range, including partially selected text elements. -
The
getSelectedElements()method is deprecated and has been replaced bygetRangeElements().
A range of elements in a document. The user's selection is represented as a Range, among
other uses. Scripts can only access the selection of the user who is running the script, and only
if the script is bound to the document.
// Bold all selected text. constselection=DocumentApp.getActiveDocument().getSelection(); if(selection){ constelements=selection.getRangeElements(); for(leti=0;i < elements.length;i++){ constelement=elements[i]; // Only modify elements that can be edited as text; skip images and other // non-text elements. if(element.getElement().editAsText){ consttext=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
| Method | Return type | Brief description |
|---|---|---|
get | Range | Gets all elements in this Range, including any partial Text elements (for example, in the case
of a selection that includes only part of a Text element). |
Deprecated methods
| Method | Return type | Brief description |
|---|---|---|
| Range | Gets all elements that the user has selected in the open instance of the document, including
any partially selected Text
elements. |
Detailed documentation
getRangeElements()
Gets all elements in this Range, including any partial Text elements (for example, in the case
of a selection that includes only part of a Text element). To determine whether a
Text element is only partially included in the range, see Range.
Return
Range — an array of elements, in the order they appear in the document
Authorization
Scripts that use this method require authorization with one or more of the following scopes:
-
https://www.googleapis.com/auth/documents.currentonly -
https://www.googleapis.com/auth/documents
Deprecated methods
(削除) getSelectedElements() (削除ここまで)
getSelectedElements() (削除ここまで)
Deprecated. Renamed to get.
Gets all elements that the user has selected in the open instance of the document, including
any partially selected Text
elements.
Return
Range — an array of selected or partially selected elements, in the order they appear in the
document
Authorization
Scripts that use this method require authorization with one or more of the following scopes:
-
https://www.googleapis.com/auth/documents.currentonly -
https://www.googleapis.com/auth/documents