Une plage d'éléments dans un document. La sélection de l'utilisateur est représentée par un Range
, parmi
d'autres utilisations. Les scripts ne peuvent accéder qu'à la sélection de l'utilisateur qui les exécute, et uniquement
si le script est lié au document.
// 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éthodes
Méthode | Type renvoyé | Brève description |
---|---|---|
getRangeElements() | RangeElement[] | Récupère tous les éléments de ce Range , y compris les éléments Text partiels (par exemple, dans le cas
d'une sélection ne comprenant qu'une partie d'un élément Text ). |
Documentation détaillée
getRangeElements()
Récupère tous les éléments de cet élément Range
, y compris les éléments Text
partiels (par exemple, dans le cas d'une sélection qui n'inclut qu'une partie d'un élément Text
). Pour déterminer si un élément Text
n'est que partiellement inclus dans la plage, consultez RangeElement.isPartial()
.
Renvois
RangeElement[]
: tableau d'éléments, dans l'ordre dans lequel ils apparaissent dans le document
Autorisation
Les scripts qui utilisent cette méthode nécessitent une autorisation correspondant à un ou plusieurs des champs d'application suivants:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents