Class Range

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);
      }
    }
  }
}

Méthodes

MéthodeType 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 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). Pour déterminer si un L'élément Text n'est que partiellement inclus dans la plage (voir 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

Méthodes obsolètes