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 qu'à la sélection de l'utilisateur qui les exécute, et uniquement s'ils sont liés 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[]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).

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 avec 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