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 auch nur dann, wenn das Skript an das Dokument gebunden ist.
// 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
Methode | Rückgabetyp | Kurzbeschreibung |
---|---|---|
getRangeElements() | RangeElement[] | Ruft alle Elemente in dieser Range ab, einschließlich aller Text -Teilelemente (z. B. bei einer Auswahl, die nur einen Teil eines Text -Elements enthält). |
Detaillierte Dokumentation
getRangeElements()
Ruft alle Elemente in dieser Range
ab, einschließlich aller Text
-Teilelemente (z. B. bei 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()
.
Return
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