Ein Element, das eine Tabellenzelle darstellt. Ein TableCell
ist immer in einem TableRow
enthalten und kann ListItem
-, Paragraph
- oder Table
-Elemente enthalten. Weitere Informationen zur Dokumentstruktur finden Sie im Leitfaden zum Erweitern von Google Docs.
Methoden
Methode | Rückgabetyp | Kurzbeschreibung |
---|---|---|
appendHorizontalRule() | HorizontalRule | Erstellt ein neues HorizontalRule -Objekt und hängt es an. |
appendImage(image) | InlineImage | Erstellt ein neues InlineImage -Objekt aus dem angegebenen Bild-Blob und hängt es an. |
appendImage(image) | InlineImage | Hängt die angegebene InlineImage an. |
appendListItem(listItem) | ListItem | Hängt die angegebene ListItem an. |
appendListItem(text) | ListItem | Erstellt ein neues ListItem -Objekt und hängt es an. |
appendParagraph(paragraph) | Paragraph | Hängt die angegebene Paragraph an. |
appendParagraph(text) | Paragraph | Erstellt ein neues Paragraph -Objekt und hängt es an. |
appendTable() | Table | Erstellt ein neues Table -Objekt und hängt es an. |
appendTable(cells) | Table | Hängt einen neuen Table an, der die angegebenen Zellen enthält. |
appendTable(table) | Table | Hängt die angegebene Table an. |
clear() | TableCell | Löscht den Inhalt des Elements. |
copy() | TableCell | Gibt eine getrennte, tiefgehende Kopie des aktuellen Elements zurück. |
editAsText() | Text | Ruft eine Text -Version des aktuellen Elements zum Bearbeiten ab. |
findElement(elementType) | RangeElement | Sucht im Inhalt des Elements nach einem Nachfolgerelement des angegebenen Typs. |
findElement(elementType, from) | RangeElement | Sucht im Inhalt des Elements nach einem Nachfolgerelement des angegebenen Typs, beginnend mit dem angegebenen RangeElement . |
findText(searchPattern) | RangeElement | Sucht den Inhalt des Elements mithilfe regulärer Ausdrücke nach dem angegebenen Textmuster. |
findText(searchPattern, from) | RangeElement | Sucht den Inhalt des Elements nach dem angegebenen Textmuster, beginnend mit einem bestimmten Suchergebnis. |
getAttributes() | Object | Ruft die Attribute des Elements ab. |
getBackgroundColor() | String | Ruft die Hintergrundfarbe ab. |
getChild(childIndex) | Element | Ruft das untergeordnete Element aus dem angegebenen untergeordneten Index ab. |
getChildIndex(child) | Integer | Ruft den untergeordneten Index für das angegebene untergeordnete Element ab |
getColSpan() | Integer | Ruft die Spaltenspanne ab, also die Anzahl der Spalten der Tabellenzellen, die diese Zelle umfasst. |
getLinkUrl() | String | Ruft die Link-URL ab. |
getNextSibling() | Element | Ruft das nächste gleichgeordnete Element des Elements ab. |
getNumChildren() | Integer | Ruft die Anzahl der untergeordneten Elemente ab. |
getPaddingBottom() | Number | Ruft den unteren Abstand in Punkten ab. |
getPaddingLeft() | Number | Ruft den linken Abstand in Punkten ab. |
getPaddingRight() | Number | Ruft den richtigen Abstand in Punkten ab. |
getPaddingTop() | Number | Ruft den oberen Abstand in Punkten ab. |
getParent() | ContainerElement | Ruft das übergeordnete Element des Elements ab. |
getParentRow() | TableRow | Ruft den TableRow mit dem aktuellen TableCell ab. |
getParentTable() | Table | Ruft den Table mit dem aktuellen TableCell ab. |
getPreviousSibling() | Element | Ruft das vorherige gleichgeordnete Element des Elements ab. |
getRowSpan() | Integer | Ruft den Zeilen-Span ab, d. h. die Anzahl der Zeilen der Tabellenzellen, die diese Zelle umfasst. |
getText() | String | Ruft den Inhalt des Elements als Textstring ab. |
getTextAlignment() | TextAlignment | Ruft die Textausrichtung ab. |
getType() | ElementType | Ruft den ElementType des Elements ab. |
getVerticalAlignment() | VerticalAlignment | Ruft die VerticalAlignment ab. |
getWidth() | Number | Ruft die Breite der Spalte mit der Zelle in Punkten ab. |
insertHorizontalRule(childIndex) | HorizontalRule | Erstellt einen neuen HorizontalRule und fügt ihn im angegebenen Index ein. |
insertImage(childIndex, image) | InlineImage | Erstellt und fügt ein InlineImage aus dem angegebenen Bild-Blob im angegebenen Index ein. |
insertImage(childIndex, image) | InlineImage | Fügt den angegebenen InlineImage in den angegebenen Index ein. |
insertListItem(childIndex, listItem) | ListItem | Fügt den angegebenen ListItem in den angegebenen Index ein. |
insertListItem(childIndex, text) | ListItem | Erstellt einen neuen ListItem und fügt ihn im angegebenen Index ein. |
insertParagraph(childIndex, paragraph) | Paragraph | Fügt den angegebenen Paragraph in den angegebenen Index ein. |
insertParagraph(childIndex, text) | Paragraph | Erstellt einen neuen Paragraph und fügt ihn im angegebenen Index ein. |
insertTable(childIndex) | Table | Erstellt einen neuen Table und fügt ihn im angegebenen Index ein. |
insertTable(childIndex, cells) | Table | Erstellt einen neuen Table , der die angegebenen Zellen am angegebenen Index enthält, und fügt ihn ein. |
insertTable(childIndex, table) | Table | Fügt den angegebenen Table in den angegebenen Index ein. |
isAtDocumentEnd() | Boolean | Bestimmt, ob sich das Element am Ende von Document befindet. |
merge() | TableCell | Führt das Element mit dem vorherigen gleichgeordneten Element desselben Typs zusammen. |
removeChild(child) | TableCell | Entfernt das angegebene untergeordnete Element. |
removeFromParent() | TableCell | Entfernt das Element aus seinem übergeordneten Element. |
replaceText(searchPattern, replacement) | Element | Ersetzt alle Vorkommen eines bestimmten Textmusters mithilfe regulärer Ausdrücke durch einen bestimmten Ersatzstring. |
setAttributes(attributes) | TableCell | Legt die Attribute des Elements fest. |
setBackgroundColor(color) | TableCell | Hier legen Sie die Hintergrundfarbe fest. |
setLinkUrl(url) | TableCell | Legt die Link-URL fest. |
setPaddingBottom(paddingBottom) | TableCell | Legt den unteren Abstand in Punkten fest. |
setPaddingLeft(paddingLeft) | TableCell | Legt den linken Abstand in Punkten fest. |
setPaddingRight(paddingRight) | TableCell | Legt den rechten Abstand in Punkten fest. |
setPaddingTop(paddingTop) | TableCell | Legt den oberen Abstand in Punkten fest. |
setText(text) | TableCell | Legt den Inhalt als Nur-Text fest. |
setTextAlignment(textAlignment) | TableCell | Legt die Textausrichtung fest. |
setVerticalAlignment(alignment) | TableCell | Legt die vertikale Ausrichtung fest. |
setWidth(width) | TableCell | Legt die Breite der Spalte mit der aktuellen Zelle in Punkten fest. |
Detaillierte Dokumentation
appendHorizontalRule()
Erstellt ein neues HorizontalRule
-Objekt und hängt es an.
HorizontalRule
wird in einem neuen Paragraph
-Objekt enthalten sein.
Return
HorizontalRule
– die neue horizontale Regel
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
appendImage(image)
Erstellt ein neues InlineImage
-Objekt aus dem angegebenen Bild-Blob und hängt es an.
InlineImage
wird in einem neuen Paragraph
-Objekt enthalten sein.
Parameter
Name | Typ | Beschreibung |
---|---|---|
image | BlobSource | die Bilddaten |
Return
InlineImage
– das neue Image
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
appendImage(image)
Hängt die angegebene InlineImage
an.
InlineImage
wird in einem neuen Paragraph
-Objekt enthalten sein.
Parameter
Name | Typ | Beschreibung |
---|---|---|
image | InlineImage | die Bilddaten |
Return
InlineImage
: das angehängte Bild
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
appendListItem(listItem)
Hängt die angegebene ListItem
an.
Parameter
Name | Typ | Beschreibung |
---|---|---|
listItem | ListItem | Listenelement, das angehängt werden soll |
Return
ListItem
: das angehängte Listenelement
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
appendListItem(text)
Erstellt ein neues ListItem
-Objekt und hängt es an.
Parameter
Name | Typ | Beschreibung |
---|---|---|
text | String | den Textinhalt |
Return
ListItem
– das neue Listenelement
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
appendParagraph(paragraph)
Hängt die angegebene Paragraph
an.
Parameter
Name | Typ | Beschreibung |
---|---|---|
paragraph | Paragraph | den hinzuzufügenden Absatz |
Return
Paragraph
: der angehängte Absatz
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
appendParagraph(text)
Erstellt ein neues Paragraph
-Objekt und hängt es an.
Parameter
Name | Typ | Beschreibung |
---|---|---|
text | String | den Textinhalt |
Return
Paragraph
– der neue Absatz
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
appendTable()
Erstellt ein neues Table
-Objekt und hängt es an.
Return
Table
– die neue Tabelle
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
appendTable(cells)
Hängt einen neuen Table
an, der die angegebenen Zellen enthält.
Parameter
Name | Typ | Beschreibung |
---|---|---|
cells | String[][] | den Textinhalt der Tabellenzellen, der der neuen Tabelle hinzugefügt werden soll |
Return
Table
– die angehängte Tabelle
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
appendTable(table)
Hängt die angegebene Table
an.
Parameter
Name | Typ | Beschreibung |
---|---|---|
table | Table | Tabelle, die angefügt werden soll |
Return
Table
– die angehängte Tabelle
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
clear()
copy()
Gibt eine getrennte, tiefgehende Kopie des aktuellen Elements zurück.
Alle untergeordneten Elemente, die im Element vorhanden sind, werden ebenfalls kopiert. Das neue Element hat kein übergeordnetes Element.
Return
TableCell
: Die neue Kopie.
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
editAsText()
Ruft eine Text
-Version des aktuellen Elements zum Bearbeiten ab.
Verwenden Sie editAsText
, um den Inhalt der Elemente im RTF-Format zu bearbeiten. Im Modus editAsText
werden Nicht-Textelemente wie InlineImage
und HorizontalRule
ignoriert.
Untergeordnete Elemente, die vollständig in einem gelöschten Textbereich enthalten sind, werden aus dem Element entfernt.
var body = DocumentApp.getActiveDocument().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);
Return
Text
: eine Textversion des aktuellen Elements
findElement(elementType)
Sucht im Inhalt des Elements nach einem Nachfolgerelement des angegebenen Typs.
Parameter
Name | Typ | Beschreibung |
---|---|---|
elementType | ElementType | Elementtyp, nach dem gesucht werden soll |
Return
RangeElement
: ein Suchergebnis, das die Position des Suchelements angibt
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
findElement(elementType, from)
Sucht im Inhalt des Elements nach einem Nachfolgerelement des angegebenen Typs, beginnend mit dem angegebenen RangeElement
.
// Get the body section of the active document. var body = DocumentApp.getActiveDocument().getBody(); // Define the search parameters. var searchType = DocumentApp.ElementType.PARAGRAPH; var searchHeading = DocumentApp.ParagraphHeading.HEADING1; var searchResult = null; // Search until the paragraph is found. while (searchResult = body.findElement(searchType, searchResult)) { var par = searchResult.getElement().asParagraph(); if (par.getHeading() == searchHeading) { // Found one, update and stop. par.setText('This is the first header.'); return; } }
Parameter
Name | Typ | Beschreibung |
---|---|---|
elementType | ElementType | Elementtyp, nach dem gesucht werden soll |
from | RangeElement | das Suchergebnis, in dem gesucht werden soll, |
Return
RangeElement
: ein Suchergebnis, das die nächste Position des Suchelements angibt
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
findText(searchPattern)
Sucht den Inhalt des Elements mithilfe regulärer Ausdrücke nach dem angegebenen Textmuster.
Einige JavaScript-Funktionen für reguläre Ausdrücke werden nicht vollständig unterstützt, z. B. Erfassungsgruppen und Modusmodifikatoren.
Das angegebene Muster für reguläre Ausdrücke wird unabhängig mit jedem Textblock im aktuellen Element abgeglichen.
Parameter
Name | Typ | Beschreibung |
---|---|---|
searchPattern | String | das Muster, nach dem gesucht werden soll |
Return
RangeElement
: ein Suchergebnis, das die Position des Suchtextes angibt, oder null, wenn es keine Übereinstimmung gibt
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
findText(searchPattern, from)
Sucht den Inhalt des Elements nach dem angegebenen Textmuster, beginnend mit einem bestimmten Suchergebnis.
Einige JavaScript-Funktionen für reguläre Ausdrücke werden nicht vollständig unterstützt, z. B. Erfassungsgruppen und Modusmodifikatoren.
Das angegebene Muster für reguläre Ausdrücke wird unabhängig mit jedem Textblock im aktuellen Element abgeglichen.
Parameter
Name | Typ | Beschreibung |
---|---|---|
searchPattern | String | das Muster, nach dem gesucht werden soll |
from | RangeElement | das Suchergebnis, in dem gesucht werden soll, |
Return
RangeElement
: ein Suchergebnis, das die nächste Position des Suchtexts angibt, oder null, wenn es keine Übereinstimmung gibt
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
getAttributes()
Ruft die Attribute des Elements ab.
Das Ergebnis ist ein Objekt, das ein Attribut für jedes gültige Elementattribut enthält, wobei jeder Attributname einem Element in der DocumentApp.Attribute
-Aufzählung entspricht.
var body = DocumentApp.getActiveDocument().getBody(); // Append a styled paragraph. var par = body.appendParagraph('A bold, italicized paragraph.'); par.setBold(true); par.setItalic(true); // Retrieve the paragraph's attributes. var atts = par.getAttributes(); // Log the paragraph attributes. for (var att in atts) { Logger.log(att + ":" + atts[att]); }
Return
Object
: Die Attribute des Elements.
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
getBackgroundColor()
Ruft die Hintergrundfarbe ab.
Return
String
: die Hintergrundfarbe, die in CSS-Notation formatiert ist (z. B. '#ffffff'
)
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
getChild(childIndex)
Ruft das untergeordnete Element aus dem angegebenen untergeordneten Index ab.
// Get the body section of the active document. var body = DocumentApp.getActiveDocument().getBody(); // Obtain the first element in the document. var 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 |
---|---|---|
childIndex | Integer | Index des abzurufenden untergeordneten Elements |
Return
Element
: das untergeordnete Element beim angegebenen Index
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
getChildIndex(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 |
Return
Integer
– der untergeordnete Index
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
getColSpan()
Ruft die Spaltenspanne ab, also die Anzahl der Spalten der Tabellenzellen, die diese Zelle umfasst. Nicht verbundene Zellen haben einen Spaltenbereich von 1.
Return
Integer
: der Spaltenbereich oder 0 für eine Zelle, die mit einer anderen Zelle verbunden ist
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
getLinkUrl()
Ruft die Link-URL ab.
Return
String
: die Link-URL oder null, wenn das Element mehrere Werte für dieses Attribut enthält
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
getNextSibling()
Ruft das nächste gleichgeordnete Element des Elements ab.
Das nächste gleichgeordnete Element hat das gleiche übergeordnete Element und folgt dem aktuellen Element.
Return
Element
: Das nächste gleichgeordnete Element.
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
getNumChildren()
Ruft die Anzahl der untergeordneten Elemente ab.
// Get the body section of the active document. var body = DocumentApp.getActiveDocument().getBody(); // Log the number of elements in the document. Logger.log("There are " + body.getNumChildren() + " elements in the document body.");
Return
Integer
: die Anzahl der untergeordneten Elemente
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
getPaddingBottom()
Ruft den unteren Abstand in Punkten ab.
Return
Number
: der untere Abstand in Punkten
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
getPaddingLeft()
Ruft den linken Abstand in Punkten ab.
Return
Number
: der linke Abstand in Punkten
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
getPaddingRight()
Ruft den richtigen Abstand in Punkten ab.
Return
Number
: das rechte Abstand in Punkten
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
getPaddingTop()
Ruft den oberen Abstand in Punkten ab.
Return
Number
: der obere Abstand in Punkten
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
getParent()
Ruft das übergeordnete Element des Elements ab.
Das übergeordnete Element enthält das aktuelle Element.
Return
ContainerElement
: Das übergeordnete Element.
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
getParentRow()
Ruft den TableRow
mit dem aktuellen TableCell
ab.
Return
TableRow
: die Tabellenzeile, die die aktuelle Zelle enthält
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
getParentTable()
Ruft den Table
mit dem aktuellen TableCell
ab.
Return
Table
: die Tabelle mit der aktuellen Zelle
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
getPreviousSibling()
Ruft das vorherige gleichgeordnete Element des Elements ab.
Das vorherige gleichgeordnete Element hat das gleiche übergeordnete Element und steht dem aktuellen Element vor.
Return
Element
: Das vorherige gleichgeordnete Element.
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
getRowSpan()
Ruft den Zeilen-Span ab, d. h. die Anzahl der Zeilen der Tabellenzellen, die diese Zelle umfasst. Nicht verbundene Zellen haben einen Zeilenbereich von 1.
Return
Integer
: der Zeilenbereich oder 0 für eine Zelle, die mit einer anderen Zelle verbunden ist
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
getText()
Ruft den Inhalt des Elements als Textstring ab.
Return
String
: der Inhalt des Elements als Textstring
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
getTextAlignment()
Ruft die Textausrichtung ab. Die verfügbaren Ausrichtungstypen sind DocumentApp.TextAlignment.NORMAL
, DocumentApp.TextAlignment.SUBSCRIPT
und DocumentApp.TextAlignment.SUPERSCRIPT
.
Return
TextAlignment
: der Typ der Textausrichtung, oder null
, wenn der Text mehrere Arten von Textausrichtungen enthält oder wenn die Textausrichtung nie festgelegt wurde
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
getType()
Ruft den ElementType
des Elements ab.
Verwenden Sie getType()
, um den genauen Typ eines bestimmten Elements zu bestimmen.
var body = DocumentApp.getActiveDocument().getBody(); // Obtain the first element in the document body. var 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.'); }
Return
ElementType
: Der Elementtyp.
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
getVerticalAlignment()
Ruft die VerticalAlignment
ab.
Return
VerticalAlignment
: die vertikale Ausrichtung
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
getWidth()
Ruft die Breite der Spalte mit der Zelle in Punkten ab.
Return
Number
: die Spaltenbreite in Punkten
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
insertHorizontalRule(childIndex)
Erstellt einen neuen HorizontalRule
und fügt ihn im angegebenen Index ein.
Die horizontale Linie wird dann in eine neue Paragraph
eingefügt.
Parameter
Name | Typ | Beschreibung |
---|---|---|
childIndex | Integer | Index, an dem das Element eingefügt werden soll |
Return
HorizontalRule
– die neue horizontale Regel
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
insertImage(childIndex, image)
Erstellt und fügt ein InlineImage
aus dem angegebenen Bild-Blob im angegebenen Index ein.
Das Bild wird in einem neuen Paragraph
enthalten.
Parameter
Name | Typ | Beschreibung |
---|---|---|
childIndex | Integer | Index, an dem das Element eingefügt werden soll |
image | BlobSource | die Bilddaten |
Return
InlineImage
: das eingefügte Inline-Bild
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
insertImage(childIndex, image)
Fügt den angegebenen InlineImage
in den angegebenen Index ein.
Das Bild wird in einem neuen Paragraph
enthalten.
Parameter
Name | Typ | Beschreibung |
---|---|---|
childIndex | Integer | Index, an dem das Element eingefügt werden soll |
image | InlineImage | das einzufügende Bild |
Return
InlineImage
: das eingefügte Inline-Bild
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
insertListItem(childIndex, listItem)
Fügt den angegebenen ListItem
in den angegebenen Index ein.
Parameter
Name | Typ | Beschreibung |
---|---|---|
childIndex | Integer | Index, an dem das Element eingefügt werden soll |
listItem | ListItem | das einzufügende Listenelement |
Return
ListItem
– neuen Listeneintrag eingefügt
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
insertListItem(childIndex, text)
Erstellt einen neuen ListItem
und fügt ihn im angegebenen Index ein.
Parameter
Name | Typ | Beschreibung |
---|---|---|
childIndex | Integer | Index, an dem das Element eingefügt werden soll |
text | String | den Textinhalt |
Return
ListItem
– das neue Listenelement
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
insertParagraph(childIndex, paragraph)
Fügt den angegebenen Paragraph
in den angegebenen Index ein.
Parameter
Name | Typ | Beschreibung |
---|---|---|
childIndex | Integer | Index, an dem das Element eingefügt werden soll |
paragraph | Paragraph | den einzufügenden Absatz |
Return
Paragraph
: der eingefügte Absatz
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
insertParagraph(childIndex, text)
Erstellt einen neuen Paragraph
und fügt ihn im angegebenen Index ein.
Parameter
Name | Typ | Beschreibung |
---|---|---|
childIndex | Integer | Index, an dem das Element eingefügt werden soll |
text | String | den Textinhalt |
Return
Paragraph
– der neue Absatz
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
insertTable(childIndex)
Erstellt einen neuen Table
und fügt ihn im angegebenen Index ein.
Parameter
Name | Typ | Beschreibung |
---|---|---|
childIndex | Integer | Index, an dem das Element eingefügt werden soll |
Return
Table
– die neue Tabelle
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
insertTable(childIndex, cells)
Erstellt einen neuen Table
, der die angegebenen Zellen am angegebenen Index enthält, und fügt ihn ein.
Parameter
Name | Typ | Beschreibung |
---|---|---|
childIndex | Integer | Index, an dem eingefügt werden soll |
cells | String[][] | den Textinhalt der Tabellenzellen, der der neuen Tabelle hinzugefügt werden soll |
Return
Table
– die neue Tabelle
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
insertTable(childIndex, table)
Fügt den angegebenen Table
in den angegebenen Index ein.
Parameter
Name | Typ | Beschreibung |
---|---|---|
childIndex | Integer | Index, an dem das Element eingefügt werden soll |
table | Table | Tabelle, die eingefügt werden soll, |
Return
Table
: die eingefügte Tabelle
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
isAtDocumentEnd()
Bestimmt, ob sich das Element am Ende von Document
befindet.
Return
Boolean
: Gibt an, ob sich das Element am Ende des Dokuments befindet.
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
merge()
Führt das Element mit dem vorherigen gleichgeordneten Element desselben Typs zusammen.
Nur Elemente derselben ElementType
können zusammengeführt werden. Alle untergeordneten Elemente, die im aktuellen Element enthalten sind, werden in das vorherige gleichgeordnete Element verschoben.
Das aktuelle Element wird aus dem Dokument entfernt.
var body = DocumentApp.getActiveDocument().getBody(); // Example 1: Merge paragraphs // Append two paragraphs to the document. var par1 = body.appendParagraph('Paragraph 1.'); var 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. var cells = [ ['Row 1, Cell 1', 'Row 1, Cell 2'], ['Row 2, Cell 1', 'Row 2, Cell 2'] ]; // Build a table from the array. var table = body.appendTable(cells); // Get the first row in the table. var row = table.getRow(0); // Get the two cells in this row. var cell1 = row.getCell(0); var cell2 = row.getCell(1); // Merge the current cell into its preceding sibling element. var merged = cell2.merge();
Return
TableCell
: Das zusammengeführte Element.
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
removeChild(child)
Entfernt das angegebene untergeordnete Element.
Parameter
Name | Typ | Beschreibung |
---|---|---|
child | Element | Das untergeordnete Element, das entfernt werden soll |
Return
TableCell
– das aktuelle Element
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
removeFromParent()
Entfernt das Element aus seinem übergeordneten Element.
var body = DocumentApp.getActiveDocument().getBody(); // Remove all images in the document body. var imgs = body.getImages(); for (var i = 0; i < imgs.length; i++) { imgs[i].removeFromParent(); }
Return
TableCell
: Das entfernte Element.
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
replaceText(searchPattern, replacement)
Ersetzt alle Vorkommen eines bestimmten Textmusters mithilfe regulärer Ausdrücke durch einen bestimmten Ersatzstring.
Das Suchmuster wird als String und nicht als JavaScript-Objekt für reguläre Ausdrücke übergeben. Aus diesem Grund müssen Sie umgekehrte Schrägstriche im Muster mit Escapezeichen versehen.
Bei dieser Methode wird die RE2 von Google für reguläre Ausdrücke verwendet, die die unterstützte Syntax begrenzt.
Das angegebene Muster für reguläre Ausdrücke wird unabhängig mit jedem Textblock im aktuellen Element abgeglichen.
var body = DocumentApp.getActiveDocument().getBody(); // Clear the text surrounding "Apps Script", with or without text. body.replaceText("^.*Apps ?Script.*$", "Apps Script");
Parameter
Name | Typ | Beschreibung |
---|---|---|
searchPattern | String | Das Regex-Muster, nach dem gesucht werden soll |
replacement | String | den als Ersatz zu verwendenden Text |
Return
Element
– das aktuelle Element
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
setAttributes(attributes)
Legt die Attribute des Elements fest.
Der angegebene Attributparameter muss ein Objekt sein, bei dem jeder Attributname ein Element in der DocumentApp.Attribute
-Aufzählung und jeder Attributwert der neue Wert ist, der angewendet werden soll.
var body = DocumentApp.getActiveDocument().getBody(); // Define a custom paragraph style. var 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. var 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. |
Return
TableCell
: Das aktuelle Element.
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
setBackgroundColor(color)
Hier legen Sie die Hintergrundfarbe fest.
Parameter
Name | Typ | Beschreibung |
---|---|---|
color | String | Hintergrundfarbe, in CSS-Notation formatiert (z. B. '#ffffff' ) |
Return
TableCell
– das aktuelle Element
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
setLinkUrl(url)
Legt die Link-URL fest.
Parameter
Name | Typ | Beschreibung |
---|---|---|
url | String | die Link-URL |
Return
TableCell
– das aktuelle Element
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
setPaddingBottom(paddingBottom)
Legt den unteren Abstand in Punkten fest.
Parameter
Name | Typ | Beschreibung |
---|---|---|
paddingBottom | Number | der untere Abstand, in Punkten |
Return
TableCell
– das aktuelle Element
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
setPaddingLeft(paddingLeft)
Legt den linken Abstand in Punkten fest.
Parameter
Name | Typ | Beschreibung |
---|---|---|
paddingLeft | Number | Abstand links, in Punkten |
Return
TableCell
– das aktuelle Element
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
setPaddingRight(paddingRight)
Legt den rechten Abstand in Punkten fest.
Parameter
Name | Typ | Beschreibung |
---|---|---|
paddingRight | Number | Der richtige Abstand in Punkten. |
Return
TableCell
: Das aktuelle Element.
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
setPaddingTop(paddingTop)
Legt den oberen Abstand in Punkten fest.
Parameter
Name | Typ | Beschreibung |
---|---|---|
paddingTop | Number | Abstand oben, in Punkten |
Return
TableCell
– das aktuelle Element
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
setText(text)
Legt den Inhalt als Nur-Text fest.
Hinweis: Vorhandene Inhalte werden gelöscht.
Parameter
Name | Typ | Beschreibung |
---|---|---|
text | String | den neuen Textinhalt |
Return
TableCell
– das aktuelle Element
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
setTextAlignment(textAlignment)
Legt die Textausrichtung fest. Die verfügbaren Ausrichtungstypen sind DocumentApp.TextAlignment.NORMAL
, DocumentApp.TextAlignment.SUBSCRIPT
und DocumentApp.TextAlignment.SUPERSCRIPT
.
// Make the entire first paragraph be superscript. var text = DocumentApp.getActiveDocument().getBody().getParagraphs()[0].editAsText(); text.setTextAlignment(DocumentApp.TextAlignment.SUPERSCRIPT);
Parameter
Name | Typ | Beschreibung |
---|---|---|
textAlignment | TextAlignment | die Art der anzuwendenden Textausrichtung |
Return
TableCell
– das aktuelle Element
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
setVerticalAlignment(alignment)
Legt die vertikale Ausrichtung fest.
Parameter
Name | Typ | Beschreibung |
---|---|---|
alignment | VerticalAlignment | die vertikale Ausrichtung |
Return
TableCell
– das aktuelle Element
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
setWidth(width)
Legt die Breite der Spalte mit der aktuellen Zelle in Punkten fest.
Parameter
Name | Typ | Beschreibung |
---|---|---|
width | Number | die Spaltenbreite in Punkten |
Return
TableCell
– das aktuelle Element
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