文档中的一组元素。用户的选择以 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