Class Range

Bereich

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

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

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). Um zu ermitteln, ob ein Das Text-Element ist nur teilweise im Bereich enthalten, siehe RangeElement.isPartial().

Rückflug

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

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

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

Verworfene Methoden