Class Range

Bereich

Eine Reihe von Elementen in einem Dokument. Die Auswahl des Nutzers wird unter anderem als Range dargestellt. Scripts können nur auf die Auswahl des Nutzers zugreifen, der das Script ausführt, und nur, wenn das Script 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

MethodeRückgabetypKurzbeschreibung
getRangeElements()RangeElement[]Hiermit werden alle Elemente in dieser Range abgerufen, einschließlich teilweiser Text-Elemente (z. B. bei einer Auswahl, die nur einen Teil eines Text-Elements enthält).

Detaillierte Dokumentation

getRangeElements()

Hiermit werden alle Elemente in dieser Range abgerufen, einschließlich teilweiser Text-Elemente (z. B. bei einer Auswahl, die nur einen Teil eines Text-Elements enthält). Ob ein Text-Element nur teilweise im Bereich enthalten ist, sehen Sie unter RangeElement.isPartial().

Rückflug

RangeElement[]: ein Array von Elementen in der Reihenfolge, in der sie im Dokument erscheinen

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

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

Eingestellte Methoden