Ein Element, das eine Tabellenzelle darstellt. Ein Table-Element ist immer in einem Table-Element enthalten und kann List-, Paragraph- oder Table-Elemente enthalten. Weitere Informationen zur Dokumentstruktur finden Sie im Leitfaden zum Erweitern von Google Docs.
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 und hängt einen neuen List an. |
append | Paragraph | Hängt die angegebene Paragraph an. |
append | Paragraph | Erstellt und hängt einen neuen Paragraph an. |
append | Table | Erstellt und hängt einen neuen Table an. |
append | Table | Fügt ein neues Table mit den angegebenen Zellen an. |
append | Table | Hängt die angegebene Table an. |
clear() | Table | Löscht den Inhalt des Elements. |
copy() | Table | 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 | String|null | Ruft die Hintergrundfarbe 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 | Integer | Ruft die Spaltenbreite ab, d. h. die Anzahl der Spalten von Tabellenzellen, die diese Zelle umfasst. |
get | String|null | Ruft die Link-URL ab. |
get | Element|null | Ruft das nächste gleichgeordnete Element des Elements ab. |
get | Integer | Ruft die Anzahl der untergeordneten Elemente ab. |
get | Number|null | Ruft den unteren Abstand in Punkten ab. |
get | Number|null | Ruft den linken Abstand in Punkten ab. |
get | Number|null | Ruft den rechten Abstand in Punkten ab. |
get | Number|null | Ruft den oberen Innenabstand in Punkten ab. |
get | Container | Ruft das übergeordnete Element des Elements ab. |
get | Table | Ruft das Table ab, das das aktuelle Table enthält. |
get | Table|null | Ruft das Table ab, das das aktuelle Table enthält. |
get | Element|null | Ruft das vorherige gleichgeordnete Element des Elements ab. |
get | Integer | Ruft den Zeilenbereich ab, d. h. die Anzahl der Zeilen mit Tabellenzellen, die diese Zelle umfasst. |
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. |
get | Vertical | Ruft die Vertical ab. |
get | Number|null | Ruft die Breite der Spalte mit der Zelle in Punkten 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. |
insert | Paragraph | Fügt das angegebene Paragraph am angegebenen Index ein. |
insert | Paragraph | Erstellt und fügt ein neues Paragraph am angegebenen Index ein. |
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. |
is | Boolean | Gibt an, ob sich das Element am Ende von Document befindet. |
merge() | Table | Führt das Element mit dem vorhergehenden gleichartigen Geschwisterelement zusammen. |
remove | Table | Entfernt das angegebene untergeordnete Element. |
remove | Table | Entfernt das Element aus dem übergeordneten Element. |
replace | Element | Ersetzt alle Vorkommen eines bestimmten Textmusters durch einen bestimmten Ersatzstring. Dabei werden reguläre Ausdrücke verwendet. |
set | Table | Legt die Attribute des Elements fest. |
set | Table | Legt die Hintergrundfarbe fest. |
set | Table | Legt die Link-URL fest. |
set | Table | Legt den unteren Abstand in Punkten fest. |
set | Table | Legt den linken Abstand in Punkten fest. |
set | Table | Legt den rechten Abstand in Punkten fest. |
set | Table | Legt den oberen Abstand in Punkten fest. |
set | Table | Legt den Inhalt als Nur-Text fest. |
set | Table | Legt die Textausrichtung fest. |
set | Table | Legt die vertikale Ausrichtung fest. |
set | Table | Legt die Breite der Spalte mit der aktuellen Zelle in Punkten 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.
Die Inline wird in einer neuen Paragraph enthalten sein.
Parameter
| Name | Typ | Beschreibung |
|---|---|---|
image | Blob | die Bilddaten |
Rückflug
Inline: Das neue 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.
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.
Parameter
| Name | Typ | Beschreibung |
|---|---|---|
list | List | Das Listenelement, das angehängt werden soll |
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 und hängt einen neuen List an.
Parameter
| Name | Typ | Beschreibung |
|---|---|---|
text | String | die Textinhalte |
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 Paragraph(paragraph)
Hängt die angegebene Paragraph an.
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 und hängt einen neuen Paragraph an.
Parameter
| Name | Typ | Beschreibung |
|---|---|---|
text | String | die Textinhalte |
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.
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)
Fügt ein neues Table mit den angegebenen Zellen an.
Parameter
| Name | Typ | Beschreibung |
|---|---|---|
cells | String[][] | den 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.
Parameter
| Name | Typ | Beschreibung |
|---|---|---|
table | Table | Die Tabelle, die angehängt werden soll |
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
Table: 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 Background Color()
Ruft die Hintergrundfarbe ab.
Rückflug
String|null: Die Hintergrundfarbe im CSS-Format (z. B. '#ffffff')
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 Col Span()
Ruft die Spaltenbreite ab, d. h. die Anzahl der Spalten von Tabellenzellen, die diese Zelle umfasst. Nicht zusammengeführte Zellen haben einen Spaltenbereich von 1.
Rückflug
Integer: Die Spaltenbreite oder 0 für eine Zelle, die von einer anderen Zelle zusammengeführt wird.
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 Link Url()
Ruft die Link-URL ab.
Rückflug
String|null: Die Link-URL oder „null“, wenn das Element mehrere Werte für dieses Attribut enthält.
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 Next Sibling()
Ruft das nächste gleichgeordnete Element des Elements ab.
Das nächste gleichgeordnete Element hat dasselbe übergeordnete Element und folgt auf das aktuelle Element.
Rückflug
Element|null: Das nächste gleichgeordnete 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 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 Padding Bottom()
Ruft den unteren Abstand in Punkten ab.
Rückflug
Number|null – der untere Abstand 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 Padding Left()
Ruft den linken Abstand in Punkten ab.
Rückflug
Number|null – der linke Abstand 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 Padding Right()
Ruft den rechten Abstand in Punkten ab.
Rückflug
Number|null – der rechte Abstand 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 Padding Top()
Ruft den oberen Innenabstand in Punkten ab.
Rückflug
Number|null: Der obere Abstand 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 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 Parent Row()
Ruft das Table ab, das das aktuelle Table enthält.
Rückflug
Table: Die Tabellenzeile, die die aktuelle Zelle enthält.
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 Table()
Ruft das Table ab, das das aktuelle Table enthält.
Rückflug
Table|null: die Tabelle, die die aktuelle Zelle enthält
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 Previous Sibling()
Ruft das vorherige gleichgeordnete Element des Elements ab.
Das vorherige gleichgeordnete Element hat dasselbe übergeordnete Element und geht dem aktuellen Element voraus.
Rückflug
Element|null: Das vorherige gleichgeordnete 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 Row Span()
Ruft den Zeilenbereich ab, d. h. die Anzahl der Zeilen mit Tabellenzellen, die diese Zelle umfasst. Nicht zusammengeführte Zellen haben einen Zeilenbereich von 1.
Rückflug
Integer: Die Zeilenüberspannung oder 0 für eine Zelle, die von einer anderen Zelle zusammengeführt wird.
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
get Vertical Alignment()
Ruft die Vertical ab.
Rückflug
Vertical – die vertikale Ausrichtung
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 Width()
Ruft die Breite der Spalte mit der Zelle in Punkten ab.
Rückflug
Number|null: die Spaltenbreite 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
insert Horizontal Rule(childIndex)
Erstellt und fügt ein neues Horizontal am angegebenen Index ein.
Die horizontale Linie wird in ein neues Paragraph-Tag eingefügt.
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.
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 | Blob | die Bilddaten |
Rückflug
Inline: das eingefügte Inline-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
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 Inline-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
insert List Item(childIndex, listItem)
Fügt das angegebene List am angegebenen Index ein.
Parameter
| Name | Typ | Beschreibung |
|---|---|---|
child | Integer | Der Index, an dem das Element eingefügt werden soll |
list | List | der einzufügende Listeneintrag |
Rückflug
List – neuer Listeneintrag eingefügt
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.
Parameter
| Name | Typ | Beschreibung |
|---|---|---|
child | Integer | Der Index, an dem das Element eingefügt werden soll |
text | String | die Textinhalte |
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 Paragraph(childIndex, paragraph)
Fügt das angegebene Paragraph am angegebenen Index ein.
Parameter
| Name | Typ | Beschreibung |
|---|---|---|
child | Integer | Der Index, an dem das Element 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.
Parameter
| Name | Typ | Beschreibung |
|---|---|---|
child | Integer | Der Index, an dem das Element eingefügt werden soll |
text | String | die Textinhalte |
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 das Element 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[][] | den 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 das Element 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
is At Document End()
Gibt an, ob sich das Element am Ende von Document befindet.
Rückflug
Boolean: Gibt an, ob sich das Element am Ende des Tabs befindet.
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
merge()
Führt das Element mit dem vorhergehenden gleichartigen Geschwisterelement zusammen.
Es können nur Elemente desselben Element zusammengeführt werden. Alle untergeordneten Elemente des aktuellen Elements werden in das vorhergehende gleichgeordnete Element verschoben.
Das aktuelle Element wird aus dem Dokument entfernt.
const doc = DocumentApp.getActiveDocument(); const documentTab = doc.getActiveTab().asDocumentTab(); const body = documentTab.getBody(); // Example 1: Merge paragraphs // Append two paragraphs to the document's active tab. const par1 = body.appendParagraph('Paragraph 1.'); const par2 = body.appendParagraph('Paragraph 2.'); // Merge the newly added paragraphs into a single paragraph. par2.merge(); // Example 2: Merge table cells // Create a two-dimensional array containing the table's cell contents. const cells = [ ['Row 1, Cell 1', 'Row 1, Cell 2'], ['Row 2, Cell 1', 'Row 2, Cell 2'], ]; // Build a table from the array. const table = body.appendTable(cells); // Get the first row in the table. const row = table.getRow(0); // Get the two cells in this row. const cell1 = row.getCell(0); const cell2 = row.getCell(1); // Merge the current cell into its preceding sibling element. const merged = cell2.merge();
Rückflug
Table: Das zusammengeführte 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
remove Child(child)
Entfernt das angegebene untergeordnete Element.
Parameter
| Name | Typ | Beschreibung |
|---|---|---|
child | Element | Das zu entfernende untergeordnete Element |
Rückflug
Table – 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
remove From Parent()
Entfernt das Element aus dem übergeordneten Element.
const doc = DocumentApp.getActiveDocument(); const documentTab = doc.getActiveTab().asDocumentTab(); const body = documentTab.getBody(); // Remove all images in the active tab's body. const imgs = body.getImages(); for (let i = 0; i < imgs.length; i++) { imgs[i].removeFromParent(); }
Rückflug
Table: Das entfernte 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
Table: 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 Background Color(color)
Legt die Hintergrundfarbe fest.
Parameter
| Name | Typ | Beschreibung |
|---|---|---|
color | String | Die Hintergrundfarbe im CSS-Format (z. B. '#ffffff') |
Rückflug
Table – 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 Link Url(url)
Legt die Link-URL fest.
Parameter
| Name | Typ | Beschreibung |
|---|---|---|
url | String | die Link-URL |
Rückflug
Table – 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 Padding Bottom(paddingBottom)
Legt den unteren Abstand in Punkten fest.
Parameter
| Name | Typ | Beschreibung |
|---|---|---|
padding | Number | den unteren Abstand in Punkten |
Rückflug
Table – 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 Padding Left(paddingLeft)
Legt den linken Abstand in Punkten fest.
Parameter
| Name | Typ | Beschreibung |
|---|---|---|
padding | Number | den linken Abstand in Punkten |
Rückflug
Table – 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 Padding Right(paddingRight)
Legt den rechten Abstand in Punkten fest.
Parameter
| Name | Typ | Beschreibung |
|---|---|---|
padding | Number | Der rechte Abstand in Punkten. |
Rückflug
Table: 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 Padding Top(paddingTop)
Legt den oberen Abstand in Punkten fest.
Parameter
| Name | Typ | Beschreibung |
|---|---|---|
padding | Number | den oberen Abstand in Punkten |
Rückflug
Table – 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 | die neuen Textinhalte |
Rückflug
Table – 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
Table – 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 Vertical Alignment(alignment)
Legt die vertikale Ausrichtung fest.
Parameter
| Name | Typ | Beschreibung |
|---|---|---|
alignment | Vertical | die vertikale Ausrichtung |
Rückflug
Table – 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 Width(width)
Legt die Breite der Spalte mit der aktuellen Zelle in Punkten fest.
Parameter
| Name | Typ | Beschreibung |
|---|---|---|
width | Number | die Spaltenbreite in Punkten |
Rückflug
Table – 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