Class Range

Bereich

Ein Bereich von Elementen in einem Dokument. Die Auswahl des Nutzers wird unter anderem als Range dargestellt. Skripts können nur auf die Auswahl des Nutzers zugreifen, der das Skript ausführt, und nur wenn das Skript an das Dokument gebunden ist.

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

Methoden

Methode	Rückgabetyp	Kurzbeschreibung
getRangeElements()	RangeElement[]	Ruft alle Elemente in diesem Range ab, einschließlich aller teilweisen Text-Elemente (z. B. im Fall einer Auswahl, die nur einen Teil eines Text-Elements enthält).

Eingestellte Methoden

Methode	Rückgabetyp	Kurzbeschreibung
getSelectedElements()	RangeElement[]	Ruft alle Elemente ab, die der Nutzer in der geöffneten Instanz des Dokuments ausgewählt hat, einschließlich aller teilweise ausgewählten Text-Elemente.

Detaillierte Dokumentation

getRangeElements()

Ruft alle Elemente in diesem Range ab, einschließlich aller teilweisen Text-Elemente (z. B. im Fall einer Auswahl, die nur einen Teil eines Text-Elements enthält). Informationen dazu, ob ein Text-Element nur teilweise im Bereich enthalten ist, finden Sie unter RangeElement.isPartial().

Rückgabe

RangeElement[] – ein Array mit Elementen in der Reihenfolge, in der sie im Dokument angezeigt werden

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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

Eingestellte Methoden

getSelectedElements()

Veraltet. Wurde in getRangeElements() umbenannt.

Ruft alle Elemente ab, die der Nutzer in der geöffneten Instanz des Dokuments ausgewählt hat, einschließlich aller teilweise ausgewählten Text-Elemente.

Rückgabe

RangeElement[] – ein Array mit ausgewählten oder teilweise ausgewählten Elementen in der Reihenfolge, in der sie im Dokument angezeigt werden

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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