Class Range

Plage

Plage d'éléments dans un document. La sélection de l'utilisateur est représentée par un Range, entre autres utilisations. Les scripts ne peuvent accéder à la sélection de l'utilisateur qui exécute le script que si le script est lié au document. 

// Bold all selected text.
const selection = DocumentApp.getActiveDocument().getSelection();
if (selection) {
  const elements = selection.getRangeElements();
  for (let i = 0; i < elements.length; i++) {
    const element = elements[i];

    // Only modify elements that can be edited as text; skip images and other
    // non-text elements.
    if (element.getElement().editAsText) {
      const 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[]Obtient tous les éléments de ce 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).

Documentation détaillée

getRangeElements()

Obtient tous les éléments de ce 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 inclus que partiellement dans la plage, consultez RangeElement.isPartial().

Renvois

RangeElement[] : tableau d'éléments, dans l'ordre où ils apparaissent dans le document

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des scopes suivants :

  • https://www.googleapis.com/auth/documents.currentonly
  • https://www.googleapis.com/auth/documents

Méthodes obsolètes