Der Inhalt eines Tabs in einem Google Docs-Dokument. Das Body-Element kann die Elemente List, Paragraph, Table und Table enthalten. Weitere Informationen zur Dokumentstruktur finden Sie im Leitfaden zum Erweitern von Google Docs.
Das Body-Element enthält in der Regel den vollständigen Inhalt des Tabs, mit Ausnahme der Elemente Header, Footer und Footnote.
const body = DocumentApp.getActiveDocument().getActiveTab().asDocumentTab().getBody(); // Append a paragraph and a page break to the tab's body section directly. body.appendParagraph('A paragraph.'); body.appendPageBreak();
Methoden
| Methode | Rückgabetyp | Kurzbeschreibung |
|---|---|---|
append | Horizontal | Erstellt und hängt einen neuen Horizontal an. |
append | Inline | Erstellt ein neues Inline aus dem angegebenen Bild-Blob und hängt es an. |
append | Inline | Hängt die angegebene Inline an. |
append | List | Hängt die angegebene List an. |
append | List | Erstellt ein neues List mit dem angegebenen Textinhalt und hängt es an. |
append | Page | Erstellt und hängt einen neuen Page an. |
append | Page | Hängt die angegebene Page an. |
append | Paragraph | Hängt die angegebene Paragraph an. |
append | Paragraph | Erstellt ein neues Paragraph mit dem angegebenen Textinhalt und hängt es an. |
append | Table | Erstellt und hängt einen neuen Table an. |
append | Table | Hängt ein neues Table mit einem Table für jeden angegebenen String-Wert an. |
append | Table | Hängt die angegebene Table an. |
clear() | Body | Löscht den Inhalt des Elements. |
copy() | Body | Gibt eine getrennte, vollständige Kopie des aktuellen Elements zurück. |
edit | Text | Ruft eine Text-Version des aktuellen Elements zur Bearbeitung ab. |
find | Range | Durchsucht den Inhalt des Elements nach einem Nachfolger des angegebenen Typs. |
find | Range | Durchsucht den Inhalt des Elements nach einem untergeordneten Element des angegebenen Typs, beginnend mit dem angegebenen Range. |
find | Range | Sucht im Inhalt des Elements mithilfe von regulären Ausdrücken nach dem angegebenen Textmuster. |
find | Range | Durchsucht den Inhalt des Elements ab einem bestimmten Suchergebnis nach dem angegebenen Textmuster. |
get | Object | Ruft die Attribute des Elements ab. |
get | Element | Ruft das untergeordnete Element am angegebenen untergeordneten Index ab. |
get | Integer | Ruft den untergeordneten Index für das angegebene untergeordnete Element ab. |
get | Object | Ruft die Attributgruppe für die angegebene Paragraph ab. |
get | Inline | Ruft alle Inline ab, die im Abschnitt enthalten sind. |
get | List | Ruft alle List ab, die im Abschnitt enthalten sind. |
get | Number|null | Ruft den unteren Rand in Punkten ab. |
get | Number|null | Ruft den linken Rand in Punkten ab. |
get | Number|null | Ruft den rechten Rand ab. |
get | Number|null | Ruft den oberen Rand ab. |
get | Integer | Ruft die Anzahl der untergeordneten Elemente ab. |
get | Number|null | Ruft die Seitenhöhe in Punkten ab. |
get | Number|null | Ruft die Seitenbreite in Punkten ab. |
get | Paragraph[]|null | Ruft alle Paragraphs ab, die im Abschnitt enthalten sind (einschließlich List). |
get | Container | Ruft das übergeordnete Element des Elements ab. |
get | Table[]|null | Ruft alle Tables ab, die im Abschnitt enthalten sind. |
get | String | Ruft den Inhalt des Elements als Textstring ab. |
get | Text | Gibt die Textausrichtung zurück. |
get | Element | Ruft den Element des Elements ab. |
insert | Horizontal | Erstellt und fügt ein neues Horizontal am angegebenen Index ein. |
insert | Inline | Erstellt und fügt ein Inline aus dem angegebenen Bild-Blob am angegebenen Index ein. |
insert | Inline | Fügt das angegebene Inline am angegebenen Index ein. |
insert | List | Fügt das angegebene List am angegebenen Index ein. |
insert | List | Erstellt und fügt ein neues List am angegebenen Index ein, das den angegebenen Textinhalt enthält. |
insert | Page | Erstellt und fügt ein neues Page am angegebenen Index ein. |
insert | Page | Fügt das angegebene Page am angegebenen Index ein. |
insert | Paragraph | Fügt das angegebene Paragraph am angegebenen Index ein. |
insert | Paragraph | Erstellt und fügt ein neues Paragraph am angegebenen Index ein, das den angegebenen Textinhalt enthält. |
insert | Table | Erstellt und fügt ein neues Table am angegebenen Index ein. |
insert | Table | Erstellt und fügt ein neues Table mit den angegebenen Zellen am angegebenen Index ein. |
insert | Table | Fügt das angegebene Table am angegebenen Index ein. |
remove | Body | Entfernt das angegebene untergeordnete Element. |
replace | Element | Ersetzt alle Vorkommen eines bestimmten Textmusters durch einen bestimmten Ersatzstring. Dabei werden reguläre Ausdrücke verwendet. |
set | Body | Legt die Attribute des Elements fest. |
set | Body | Legt die Attribute für die angegebene Paragraph fest. |
set | Body | Legt den unteren Rand in Punkten fest. |
set | Body | Legt den linken Rand in Punkten fest. |
set | Body | Legt den rechten Rand in Punkten fest. |
set | Body | Legt den oberen Rand fest. |
set | Body | Legt die Seitenhöhe in Punkten fest. |
set | Body | Legt die Seitenbreite in Punkten fest. |
set | Body | Legt den Inhalt als Nur-Text fest. |
set | Body | Legt die Textausrichtung fest. |
Detaillierte Dokumentation
append Horizontal Rule()
Erstellt und hängt einen neuen Horizontal an.
Die Horizontal wird in einer neuen Paragraph enthalten sein.
Rückflug
Horizontal: Die neue horizontale Linie.
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
append Image(image)
Erstellt ein neues Inline aus dem angegebenen Bild-Blob und hängt es an.
Das Bild wird in einem neuen Paragraph enthalten sein.
Parameter
| Name | Typ | Beschreibung |
|---|---|---|
image | Blob | Die Bilddaten. |
Rückflug
Inline: Das angehängte Bild.
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
append Image(image)
Hängt die angegebene Inline an.
Die Inline wird in einer neuen Paragraph enthalten sein.
Verwenden Sie diese Version von append, wenn Sie eine Kopie eines vorhandenen Inline anhängen.
Parameter
| Name | Typ | Beschreibung |
|---|---|---|
image | Inline | Die Bilddaten. |
Rückflug
Inline: Das angehängte Bild.
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
append List Item(listItem)
Hängt die angegebene List an.
Verwenden Sie diese Version von append, wenn Sie eine Kopie eines vorhandenen List anhängen.
Parameter
| Name | Typ | Beschreibung |
|---|---|---|
list | List | Der anzuhängende Listeneintrag. |
Rückflug
List: Das angehängte Listenelement.
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
append List Item(text)
Erstellt ein neues List mit dem angegebenen Textinhalt und hängt es an.
Aufeinanderfolgende Listenelemente werden als Teil derselben Liste hinzugefügt.
Parameter
| Name | Typ | Beschreibung |
|---|---|---|
text | String | Der Textinhalt des Listenelements. |
Rückflug
List – Das neue Listenelement.
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
append Page Break()
Erstellt und hängt einen neuen Page an.
Die Page wird in einer neuen Paragraph enthalten sein.
Rückflug
Page: Der neue Seitenumbruch.
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
append Page Break(pageBreak)
Hängt die angegebene Page an.
Die Page wird in einer neuen Paragraph enthalten sein.
Verwenden Sie diese Version von append, wenn Sie eine Kopie eines vorhandenen Page anhängen.
Parameter
| Name | Typ | Beschreibung |
|---|---|---|
page | Page | Der anzuhängende Seitenumbruch. |
Rückflug
Page: Der angehängte Seitenumbruch.
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
append Paragraph(paragraph)
Hängt die angegebene Paragraph an.
Verwenden Sie diese Version von append, wenn Sie eine Kopie eines vorhandenen Paragraph anhängen.
Parameter
| Name | Typ | Beschreibung |
|---|---|---|
paragraph | Paragraph | Der anzuhängende Absatz. |
Rückflug
Paragraph – Der angehängte Absatz.
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
append Paragraph(text)
Erstellt ein neues Paragraph mit dem angegebenen Textinhalt und hängt es an.
Parameter
| Name | Typ | Beschreibung |
|---|---|---|
text | String | Der Textinhalt des Absatzes. |
Rückflug
Paragraph – Der neue Absatz.
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
append Table()
Erstellt und hängt einen neuen Table an.
Bei dieser Methode wird auch ein leerer Absatz nach der Tabelle angehängt, da Google Docs-Dokumente nicht mit einer Tabelle enden können.
Rückflug
Table: Die neue Tabelle.
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
append Table(cells)
Hängt ein neues Table mit einem Table für jeden angegebenen String-Wert an.
Bei dieser Methode wird auch ein leerer Absatz nach der Tabelle angehängt, da Google Docs-Dokumente nicht mit einer Tabelle enden können.
Parameter
| Name | Typ | Beschreibung |
|---|---|---|
cells | String[][] | Der Textinhalt der Tabellenzellen, die der neuen Tabelle hinzugefügt werden sollen. |
Rückflug
Table: Die angehängte Tabelle.
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
append Table(table)
Hängt die angegebene Table an.
Verwenden Sie diese Version von append, wenn Sie eine Kopie eines vorhandenen Table anhängen.
Bei dieser Methode wird auch ein leerer Absatz nach der Tabelle angehängt, da Google Docs-Dokumente nicht mit einer Tabelle enden können.
Parameter
| Name | Typ | Beschreibung |
|---|---|---|
table | Table | Die anzuhängende Tabelle. |
Rückflug
Table: Die angehängte Tabelle.
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
clear()
copy()
Gibt eine getrennte, vollständige Kopie des aktuellen Elements zurück.
Alle untergeordneten Elemente des Elements werden ebenfalls kopiert. Das neue Element hat kein übergeordnetes Element.
Rückflug
Body: Der neue Text.
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
edit As Text()
Ruft eine Text-Version des aktuellen Elements zur Bearbeitung ab.
Verwenden Sie edit, um den Inhalt der Elemente als Rich-Text zu bearbeiten. Im edit-Modus werden nicht textbasierte Elemente wie Inline und Horizontal ignoriert.
Untergeordnete Elemente, die vollständig in einem gelöschten Textbereich enthalten sind, werden aus dem Element entfernt.
const body = DocumentApp.getActiveDocument().getActiveTab().asDocumentTab().getBody(); // Insert two paragraphs separated by a paragraph containing an // horizontal rule. body.insertParagraph(0, 'An editAsText sample.'); body.insertHorizontalRule(0); body.insertParagraph(0, 'An example.'); // Delete " sample.\n\n An" removing the horizontal rule in the process. body.editAsText().deleteText(14, 25);
Rückflug
Text: eine Textversion des aktuellen Elements
find Element(elementType)
Durchsucht den Inhalt des Elements nach einem Nachfolger des angegebenen Typs.
Parameter
| Name | Typ | Beschreibung |
|---|---|---|
element | Element | Der Elementtyp, nach dem gesucht werden soll. |
Rückflug
Range: Ein Suchergebnis, das die Position des Suchelements angibt.
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
find Element(elementType, from)
Durchsucht den Inhalt des Elements nach einem untergeordneten Element des angegebenen Typs, beginnend mit dem angegebenen Range.
const body = DocumentApp.getActiveDocument().getActiveTab().asDocumentTab().getBody(); // Define the search parameters. let searchResult = null; // Search until the paragraph is found. while ( (searchResult = body.findElement( DocumentApp.ElementType.PARAGRAPH, searchResult, ))) { const par = searchResult.getElement().asParagraph(); if (par.getHeading() === DocumentApp.ParagraphHeading.HEADING1) { // Found one, update and stop. par.setText('This is the first header.'); break; } }
Parameter
| Name | Typ | Beschreibung |
|---|---|---|
element | Element | Der Elementtyp, nach dem gesucht werden soll. |
from | Range | Das Suchergebnis, von dem aus gesucht werden soll. |
Rückflug
Range: Ein Suchergebnis, das die nächste Position des Suchelements angibt.
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
find Text(searchPattern)
Sucht im Inhalt des Elements mithilfe von regulären Ausdrücken nach dem angegebenen Textmuster.
Eine Teilmenge der Funktionen für reguläre JavaScript-Ausdrücke wird nicht vollständig unterstützt, z. B. Erfassungsgruppen und Modusmodifikatoren.
Das bereitgestellte Muster des regulären Ausdrucks wird unabhängig mit jedem Textblock im aktuellen Element abgeglichen.
Parameter
| Name | Typ | Beschreibung |
|---|---|---|
search | String | das Muster, nach dem gesucht werden soll |
Rückflug
Range: Ein Suchergebnis, das die Position des Suchtexts angibt, oder „null“, wenn keine Übereinstimmung vorliegt.
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
find Text(searchPattern, from)
Durchsucht den Inhalt des Elements ab einem bestimmten Suchergebnis nach dem angegebenen Textmuster.
Eine Teilmenge der Funktionen für reguläre JavaScript-Ausdrücke wird nicht vollständig unterstützt, z. B. Erfassungsgruppen und Modusmodifikatoren.
Das bereitgestellte Muster des regulären Ausdrucks wird unabhängig mit jedem Textblock im aktuellen Element abgeglichen.
Parameter
| Name | Typ | Beschreibung |
|---|---|---|
search | String | das Muster, nach dem gesucht werden soll |
from | Range | das Suchergebnis, von dem aus gesucht werden soll |
Rückflug
Range: Ein Suchergebnis, das die nächste Position des Suchtexts angibt, oder „null“, wenn keine Übereinstimmung vorhanden ist.
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
get Attributes()
Ruft die Attribute des Elements ab.
Das Ergebnis ist ein Objekt, das für jedes gültige Elementattribut eine Property enthält. Jeder Property-Name entspricht einem Element in der Document-Aufzählung.
const doc = DocumentApp.getActiveDocument(); const documentTab = doc.getActiveTab().asDocumentTab(); const body = documentTab.getBody(); // Append a styled paragraph. const par = body.appendParagraph('A bold, italicized paragraph.'); par.setBold(true); par.setItalic(true); // Retrieve the paragraph's attributes. const atts = par.getAttributes(); // Log the paragraph attributes. for (const att in atts) { Logger.log(`${att}:${atts[att]}`); }
Rückflug
Object: Die Attribute des Elements.
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
get Child(childIndex)
Ruft das untergeordnete Element am angegebenen untergeordneten Index ab.
const body = DocumentApp.getActiveDocument().getActiveTab().asDocumentTab().getBody(); // Obtain the first element in the tab. const firstChild = body.getChild(0); // If it's a paragraph, set its contents. if (firstChild.getType() === DocumentApp.ElementType.PARAGRAPH) { firstChild.asParagraph().setText('This is the first paragraph.'); }
Parameter
| Name | Typ | Beschreibung |
|---|---|---|
child | Integer | Der Index des untergeordneten Elements, das abgerufen werden soll. |
Rückflug
Element: Das untergeordnete Element am angegebenen Index.
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
get Child Index(child)
Ruft den untergeordneten Index für das angegebene untergeordnete Element ab.
Parameter
| Name | Typ | Beschreibung |
|---|---|---|
child | Element | Das untergeordnete Element, für das der Index abgerufen werden soll. |
Rückflug
Integer – Der untergeordnete Index.
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
get Heading Attributes(paragraphHeading)
Ruft die Attributgruppe für die angegebene Paragraph ab.
Parameter
| Name | Typ | Beschreibung |
|---|---|---|
paragraph | Paragraph | Die Überschrift, deren Attribute abgerufen werden sollen. |
Rückflug
Object: Eine Zuordnung der Attribute und ihrer aktuellen Werte.
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
get Images()
Ruft alle Inline ab, die im Abschnitt enthalten sind.
Rückflug
Inline – Die Bilder des Abschnitts.
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
get List Items()
Ruft alle List ab, die im Abschnitt enthalten sind.
Rückflug
List: Die Elemente der Bereichsliste.
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
get Margin Bottom()
Ruft den unteren Rand in Punkten ab.
Rückflug
Number|null: Der untere Rand in Punkten.
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
get Margin Left()
Ruft den linken Rand in Punkten ab.
Rückflug
Number|null: Der linke Rand in Punkten.
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
get Margin Right()
Ruft den rechten Rand ab.
Rückflug
Number|null: Der rechte Rand in Punkten.
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
get Margin Top()
Ruft den oberen Rand ab.
Rückflug
Number|null: Der obere Rand in Punkten.
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
get Num Children()
Ruft die Anzahl der untergeordneten Elemente ab.
const body = DocumentApp.getActiveDocument().getActiveTab().asDocumentTab().getBody(); // Log the number of elements in the tab. Logger.log(`There are ${body.getNumChildren()} elements in the tab's body.`);
Rückflug
Integer – Die Anzahl der untergeordneten Elemente.
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
get Page Height()
Ruft die Seitenhöhe in Punkten ab.
Rückflug
Number|null: Die Seitenhöhe in Punkten.
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
get Page Width()
Ruft die Seitenbreite in Punkten ab.
Rückflug
Number|null: Die Seitenbreite in Punkten.
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
get Paragraphs()
Ruft alle Paragraphs ab, die im Abschnitt enthalten sind (einschließlich List).
Rückflug
Paragraph[]|null – Die Absätze des Abschnitts.
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
get Parent()
Ruft das übergeordnete Element des Elements ab.
Das übergeordnete Element enthält das aktuelle Element.
Rückflug
Container: Das übergeordnete Element.
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
get Tables()
Ruft alle Tables ab, die im Abschnitt enthalten sind.
Rückflug
Table[]|null – Die Tabellen im Abschnitt.
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
get Text()
Ruft den Inhalt des Elements als Textstring ab.
Rückflug
String – der Inhalt des Elements als Textstring
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
get Text Alignment()
Gibt die Textausrichtung zurück. Die verfügbaren Ausrichtungstypen sind Document, Document und Document.
Rückflug
Text: Der Typ der Textausrichtung oder null, wenn der Text mehrere Arten von Textausrichtungen enthält oder die Textausrichtung noch nie festgelegt wurde.
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
get Type()
Ruft den Element des Elements ab.
Mit get können Sie den genauen Typ eines bestimmten Elements ermitteln.
const doc = DocumentApp.getActiveDocument(); const documentTab = doc.getActiveTab().asDocumentTab(); const body = documentTab.getBody(); // Obtain the first element in the active tab's body. const firstChild = body.getChild(0); // Use getType() to determine the element's type. if (firstChild.getType() === DocumentApp.ElementType.PARAGRAPH) { Logger.log('The first element is a paragraph.'); } else { Logger.log('The first element is not a paragraph.'); }
Rückflug
Element: Der Elementtyp.
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
insert Horizontal Rule(childIndex)
Erstellt und fügt ein neues Horizontal am angegebenen Index ein.
Die Horizontal wird in einer neuen Paragraph enthalten sein.
Parameter
| Name | Typ | Beschreibung |
|---|---|---|
child | Integer | Der Index, an dem das Element eingefügt werden soll. |
Rückflug
Horizontal: Die neue horizontale Linie.
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
insert Image(childIndex, image)
Erstellt und fügt ein Inline aus dem angegebenen Bild-Blob am angegebenen Index ein.
Parameter
| Name | Typ | Beschreibung |
|---|---|---|
child | Integer | Der Index, an dem das Element eingefügt werden soll. |
image | Blob | Die Bilddaten. |
Rückflug
Inline: Das eingefügte Inlinebild.
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
insert Image(childIndex, image)
Fügt das angegebene Inline am angegebenen Index ein.
Das Bild wird in einem neuen Paragraph enthalten sein.
Parameter
| Name | Typ | Beschreibung |
|---|---|---|
child | Integer | Der Index, an dem das Element eingefügt werden soll. |
image | Inline | Das einzufügende Bild. |
Rückflug
Inline: Das eingefügte Inlinebild.
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
insert List Item(childIndex, listItem)
Fügt das angegebene List am angegebenen Index ein.
Parameter
| Name | Typ | Beschreibung |
|---|---|---|
child | Integer | Der Index, an dem eingefügt werden soll. |
list | List | Der einzufügende Listeneintrag. |
Rückflug
List: Der eingefügte Listeneintrag.
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
insert List Item(childIndex, text)
Erstellt und fügt ein neues List am angegebenen Index ein, das den angegebenen Textinhalt enthält.
Parameter
| Name | Typ | Beschreibung |
|---|---|---|
child | Integer | Der Index, an dem eingefügt werden soll. |
text | String | Der Textinhalt des Listenelements. |
Rückflug
List – Das neue Listenelement.
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
insert Page Break(childIndex)
Erstellt und fügt ein neues Page am angegebenen Index ein.
Die Page wird in einer neuen Paragraph enthalten sein.
Parameter
| Name | Typ | Beschreibung |
|---|---|---|
child | Integer | Der Index, an dem das Element eingefügt werden soll. |
Rückflug
Page: Der neue Seitenumbruch.
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
insert Page Break(childIndex, pageBreak)
Fügt das angegebene Page am angegebenen Index ein.
Die Page wird in einer neuen Paragraph enthalten sein.
Parameter
| Name | Typ | Beschreibung |
|---|---|---|
child | Integer | Der Index, an dem das Element eingefügt werden soll. |
page | Page | Der einzufügende Seitenumbruch. |
Rückflug
Page: Der eingefügte Seitenumbruch.
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
insert Paragraph(childIndex, paragraph)
Fügt das angegebene Paragraph am angegebenen Index ein.
Parameter
| Name | Typ | Beschreibung |
|---|---|---|
child | Integer | Der Index, an dem eingefügt werden soll. |
paragraph | Paragraph | Der einzufügende Absatz. |
Rückflug
Paragraph: Der eingefügte Absatz.
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
insert Paragraph(childIndex, text)
Erstellt und fügt ein neues Paragraph am angegebenen Index ein, das den angegebenen Textinhalt enthält.
Parameter
| Name | Typ | Beschreibung |
|---|---|---|
child | Integer | Der Index, an dem eingefügt werden soll. |
text | String | Der Textinhalt des Absatzes. |
Rückflug
Paragraph – Der neue Absatz.
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
insert Table(childIndex)
Erstellt und fügt ein neues Table am angegebenen Index ein.
Parameter
| Name | Typ | Beschreibung |
|---|---|---|
child | Integer | Der Index, an dem eingefügt werden soll. |
Rückflug
Table: Die neue Tabelle.
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
insert Table(childIndex, cells)
Erstellt und fügt ein neues Table mit den angegebenen Zellen am angegebenen Index ein.
Parameter
| Name | Typ | Beschreibung |
|---|---|---|
child | Integer | Der Index, an dem eingefügt werden soll. |
cells | String[][] | Der Textinhalt der Tabellenzellen, die der neuen Tabelle hinzugefügt werden sollen. |
Rückflug
Table: Die neue Tabelle.
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
insert Table(childIndex, table)
Fügt das angegebene Table am angegebenen Index ein.
Parameter
| Name | Typ | Beschreibung |
|---|---|---|
child | Integer | Der Index, an dem eingefügt werden soll. |
table | Table | Die einzufügende Tabelle. |
Rückflug
Table: Die eingefügte Tabelle.
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
remove Child(child)
Entfernt das angegebene untergeordnete Element.
Parameter
| Name | Typ | Beschreibung |
|---|---|---|
child | Element | Das untergeordnete Element, das entfernt werden soll. |
Rückflug
Body: Das aktuelle Element.
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
replace Text(searchPattern, replacement)
Ersetzt alle Vorkommen eines bestimmten Textmusters durch einen bestimmten Ersatzstring. Dabei werden reguläre Ausdrücke verwendet.
Das Suchmuster wird als String und nicht als reguläres JavaScript-Ausdrucksobjekt übergeben. Aus diesem Grund müssen Sie alle umgekehrten Schrägstriche im Muster maskieren.
Für diese Methode wird die RE2-Bibliothek für reguläre Ausdrücke von Google verwendet, wodurch die unterstützte Syntax eingeschränkt wird.
Das bereitgestellte Muster des regulären Ausdrucks wird unabhängig mit jedem Textblock im aktuellen Element abgeglichen.
const body = DocumentApp.getActiveDocument().getActiveTab().asDocumentTab().getBody(); // Clear the text surrounding "Apps Script", with or without text. body.replaceText('^.*Apps ?Script.*$', 'Apps Script');
Parameter
| Name | Typ | Beschreibung |
|---|---|---|
search | String | Das Regex-Muster, nach dem gesucht werden soll |
replacement | String | den Text, der als Ersatz verwendet werden soll |
Rückflug
Element – das aktuelle Element
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
set Attributes(attributes)
Legt die Attribute des Elements fest.
Der angegebene Parameter „attributes“ muss ein Objekt sein, in dem jeder Attributname ein Element in der Aufzählung Document ist und jeder Attributwert der neue Wert ist, der angewendet werden soll.
const doc = DocumentApp.getActiveDocument(); const documentTab = doc.getActiveTab().asDocumentTab(); const body = documentTab.getBody(); // Define a custom paragraph style. const style = {}; style[DocumentApp.Attribute.HORIZONTAL_ALIGNMENT] = DocumentApp.HorizontalAlignment.RIGHT; style[DocumentApp.Attribute.FONT_FAMILY] = 'Calibri'; style[DocumentApp.Attribute.FONT_SIZE] = 18; style[DocumentApp.Attribute.BOLD] = true; // Append a plain paragraph. const par = body.appendParagraph('A paragraph with custom style.'); // Apply the custom style. par.setAttributes(style);
Parameter
| Name | Typ | Beschreibung |
|---|---|---|
attributes | Object | Die Attribute des Elements. |
Rückflug
Body: Das aktuelle Element.
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
set Heading Attributes(paragraphHeading, attributes)
Legt die Attribute für die angegebene Paragraph fest.
Parameter
| Name | Typ | Beschreibung |
|---|---|---|
paragraph | Paragraph | Die Überschrift, deren Attribute festgelegt werden sollen. |
attributes | Object | Eine Zuordnung von Attributen und den Werten, auf die sie festgelegt werden sollen. |
Rückflug
Body: Das aktuelle Element.
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
set Margin Bottom(marginBottom)
Legt den unteren Rand in Punkten fest.
Parameter
| Name | Typ | Beschreibung |
|---|---|---|
margin | Number | Der untere Rand in Punkten. |
Rückflug
Body: Das aktuelle Element.
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
set Margin Left(marginLeft)
Legt den linken Rand in Punkten fest.
Parameter
| Name | Typ | Beschreibung |
|---|---|---|
margin | Number | Der linke Rand in Punkten. |
Rückflug
Body: Das aktuelle Element.
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
set Margin Right(marginRight)
Legt den rechten Rand in Punkten fest.
Parameter
| Name | Typ | Beschreibung |
|---|---|---|
margin | Number | Rechter Rand |
Rückflug
Body: Das aktuelle Element.
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
set Margin Top(marginTop)
Legt den oberen Rand fest.
Parameter
| Name | Typ | Beschreibung |
|---|---|---|
margin | Number | Der obere Rand in Punkten. |
Rückflug
Body: Das aktuelle Element.
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
set Page Height(pageHeight)
Legt die Seitenhöhe in Punkten fest.
Parameter
| Name | Typ | Beschreibung |
|---|---|---|
page | Number | Die Seitenhöhe in Punkten. |
Rückflug
Body: Das aktuelle Element.
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
set Page Width(pageWidth)
Legt die Seitenbreite in Punkten fest.
Parameter
| Name | Typ | Beschreibung |
|---|---|---|
page | Number | Die Seitenbreite in Punkten. |
Rückflug
Body: Das aktuelle Element.
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
set Text(text)
Legt den Inhalt als Nur-Text fest.
Hinweis: Vorhandene Inhalte werden gelöscht.
Parameter
| Name | Typ | Beschreibung |
|---|---|---|
text | String | Der neue Textinhalt. |
Rückflug
Body: Das aktuelle Element.
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
set Text Alignment(textAlignment)
Legt die Textausrichtung fest. Die verfügbaren Ausrichtungstypen sind Document, Document und Document.
// Make the entire first paragraph in the active tab be superscript. const documentTab = DocumentApp.getActiveDocument().getActiveTab().asDocumentTab(); const text = documentTab.getBody().getParagraphs()[0].editAsText(); text.setTextAlignment(DocumentApp.TextAlignment.SUPERSCRIPT);
Parameter
| Name | Typ | Beschreibung |
|---|---|---|
text | Text | die Art der anzuwendenden Textausrichtung |
Rückflug
Body – das aktuelle Element
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