Un rango de elementos en un documento. La selección del usuario se representa como un elemento Range
, entre otros usos. Las secuencias de comandos solo pueden acceder a la selección del usuario que ejecuta la secuencia de comandos, y solo si está vinculada al documento.
// 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); } } } }
Métodos
Método | Tipo de datos que se muestra | Descripción breve |
---|---|---|
getRangeElements() | RangeElement[] | Obtiene todos los elementos de esta Range , incluidos los elementos Text parciales (por ejemplo, en el caso de una selección que incluye solo una parte de un elemento Text ). |
Documentación detallada
getRangeElements()
Obtiene todos los elementos de esta Range
, incluidos los elementos Text
parciales (por ejemplo, en el caso de una selección que incluye solo una parte de un elemento Text
). Para determinar si un elemento Text
solo se incluye parcialmente en el rango, consulta RangeElement.isPartial()
.
Devolvedor
RangeElement[]
: Es un array de elementos, en el orden en que aparecen en el documento.
Autorización
Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes alcances:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents