Restez organisé à l'aide des collections
Enregistrez et classez les contenus selon vos préférences.
Plage
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);
}
}
}
}
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).
Récupère tous les éléments sélectionnés par l'utilisateur dans l'instance ouverte du document, y compris
toutes les Text partiellement sélectionnées
éléments.
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:
Récupère tous les éléments que l'utilisateur a sélectionnés dans l'instance ouverte du document, y compris les éléments Text partiellement sélectionnés.
Renvois
RangeElement[] : tableau d'éléments sélectionnés ou partiellement sélectionnés, 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:
Sauf indication contraire, le contenu de cette page est régi par une licence Creative Commons Attribution 4.0, et les échantillons de code sont régis par une licence Apache 2.0. Pour en savoir plus, consultez les Règles du site Google Developers. Java est une marque déposée d'Oracle et/ou de ses sociétés affiliées.
Dernière mise à jour le 2024/09/13 (UTC).
[[["Facile à comprendre","easyToUnderstand","thumb-up"],["J'ai pu résoudre mon problème","solvedMyProblem","thumb-up"],["Autre","otherUp","thumb-up"]],[["Il n'y a pas l'information dont j'ai besoin","missingTheInformationINeed","thumb-down"],["Trop compliqué/Trop d'étapes","tooComplicatedTooManySteps","thumb-down"],["Obsolète","outOfDate","thumb-down"],["Problème de traduction","translationIssue","thumb-down"],["Mauvais exemple/Erreur de code","samplesCodeIssue","thumb-down"],["Autre","otherDown","thumb-down"]],["Dernière mise à jour le 2024/09/13 (UTC)."],[[["A `Range` represents 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 by `getRangeElements()`."]]],[]]