Ein Element, das eine Tabellenzelle darstellt. Ein TableCell
ist immer in einem TableRow
enthalten und kann ListItem
-, Paragraph
- oder Table
-Elemente enthalten. Für
Weitere Informationen zur Dokumentstruktur finden Sie im Leitfaden zum Erweitern von Google Docs.
Methoden
Methode | Rückgabetyp | Kurzbeschreibung |
---|---|---|
appendHorizontalRule() | HorizontalRule | Erstellt eine neue HorizontalRule und hängt sie an. |
appendImage(image) | InlineImage | Erstellt eine neue InlineImage aus dem angegebenen Bild-Blob und hängt sie an. |
appendImage(image) | InlineImage | Hängt die angegebene InlineImage an. |
appendListItem(listItem) | ListItem | Hängt die angegebene ListItem an. |
appendListItem(text) | ListItem | Erstellt eine neue ListItem und hängt sie an. |
appendParagraph(paragraph) | Paragraph | Hängt die angegebene Paragraph an. |
appendParagraph(text) | Paragraph | Erstellt eine neue Paragraph und hängt sie an. |
appendTable() | Table | Erstellt eine neue Table und hängt sie an. |
appendTable(cells) | Table | Hängt eine neue Table an, die 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 losgelöste, tiefe Kopie des aktuellen Elements zurück. |
editAsText() | Text | Ruft eine Text -Version des aktuellen Elements zur Bearbeitung 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
angegeben: RangeElement . |
findText(searchPattern) | RangeElement | Sucht mithilfe regulärer Ausdrücke im Inhalt des Elements nach dem angegebenen Textmuster. |
findText(searchPattern, from) | RangeElement | Sucht im Inhalt des Elements nach dem angegebenen Textmuster, beginnend mit einem bestimmten in den Suchergebnissen. |
getAttributes() | Object | Ruft die Attribute des Elements ab. |
getBackgroundColor() | String | Ruft die Hintergrundfarbe ab. |
getChild(childIndex) | Element | Ruft das untergeordnete Element im angegebenen untergeordneten Index ab. |
getChildIndex(child) | Integer | Ruft den untergeordneten Index für das angegebene untergeordnete Element ab |
getColSpan() | Integer | Ruft den Spaltenbereich ab, also die Anzahl der Spalten von 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 die TableRow mit dem aktuellen TableCell ab. |
getParentTable() | Table | Ruft die Table mit dem aktuellen TableCell ab. |
getPreviousSibling() | Element | Ruft das vorherige gleichgeordnete Element des Elements ab |
getRowSpan() | Integer | Ruft den Zeilenbereich ab, also die Anzahl der Zeilen von 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 eine neue HorizontalRule und fügt sie im angegebenen Index ein. |
insertImage(childIndex, image) | InlineImage | Erstellt und fügt einen InlineImage aus dem angegebenen Bild-BLOB am angegebenen
-Index. |
insertImage(childIndex, image) | InlineImage | Fügt den angegebenen InlineImage im angegebenen Index ein. |
insertListItem(childIndex, listItem) | ListItem | Fügt den angegebenen ListItem im angegebenen Index ein. |
insertListItem(childIndex, text) | ListItem | Erstellt eine neue ListItem und fügt sie im angegebenen Index ein. |
insertParagraph(childIndex, paragraph) | Paragraph | Fügt den angegebenen Paragraph im angegebenen Index ein. |
insertParagraph(childIndex, text) | Paragraph | Erstellt eine neue Paragraph und fügt sie im angegebenen Index ein. |
insertTable(childIndex) | Table | Erstellt eine neue Table und fügt sie im angegebenen Index ein. |
insertTable(childIndex, cells) | Table | Erstellt eine neue Table und fügt sie ein, die die angegebenen Zellen am angegebenen Index enthält. |
insertTable(childIndex, table) | Table | Fügt den angegebenen Table im angegebenen Index ein. |
isAtDocumentEnd() | Boolean | Bestimmt, ob sich das Element am Ende von Document befindet. |
merge() | TableCell | Führt das Element mit dem vorangehenden gleichgeordneten Element desselben Typs zusammen. |
removeChild(child) | TableCell | Entfernt das angegebene untergeordnete Element. |
removeFromParent() | TableCell | Entfernt das Element aus dem übergeordneten Element. |
replaceText(searchPattern, replacement) | Element | Ersetzt alle Vorkommen eines bestimmten Textmusters durch einen bestimmten Ersatzstring, wobei die reguläre Ausdrücke. |
setAttributes(attributes) | TableCell | Legt die Attribute des Elements fest. |
setBackgroundColor(color) | TableCell | Legt 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 richtigen 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 eine neue HorizontalRule
und hängt sie an.
HorizontalRule
wird in einer neuen Paragraph
enthalten.
Rückflug
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 eine neue InlineImage
aus dem angegebenen Bild-Blob und hängt sie an.
InlineImage
wird in einer neuen Paragraph
enthalten.
Parameter
Name | Typ | Beschreibung |
---|---|---|
image | BlobSource | die Bilddaten |
Rückflug
InlineImage
– das neue 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
appendImage(image)
Hängt die angegebene InlineImage
an.
InlineImage
wird in einer neuen Paragraph
enthalten.
Parameter
Name | Typ | Beschreibung |
---|---|---|
image | InlineImage | die Bilddaten |
Rückflug
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 | das Listenelement, das angehängt werden soll |
Rückflug
ListItem
– der angehängte Listeneintrag
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 eine neue ListItem
und hängt sie an.
Parameter
Name | Typ | Beschreibung |
---|---|---|
text | String | Textinhalt |
Rückflug
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 Absatz, der angefügt werden soll |
Rückflug
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 eine neue Paragraph
und hängt sie an.
Parameter
Name | Typ | Beschreibung |
---|---|---|
text | String | Textinhalt |
Rückflug
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 eine neue Table
und hängt sie an.
Rückflug
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 eine neue Table
an, die die angegebenen Zellen enthält.
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
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 | die anzufügende Tabelle. |
Rückflug
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 losgelöste, tiefe Kopie des aktuellen Elements zurück.
Alle im Element vorhandenen untergeordneten Elemente werden ebenfalls kopiert. Das neue Element hat kein Parent.
Rückflug
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 zur Bearbeitung ab.
Verwenden Sie editAsText
, um den Inhalt der Elemente als RTF 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().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
findElement(elementType)
Sucht im Inhalt des Elements nach einem Nachfolgerelement des angegebenen Typs.
Parameter
Name | Typ | Beschreibung |
---|---|---|
elementType | ElementType | Der Elementtyp, nach dem gesucht werden soll. |
Rückflug
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
angegeben: RangeElement
.
var body = DocumentApp.getActiveDocument().getActiveTab().asDocumentTab().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 | Der Elementtyp, nach dem gesucht werden soll. |
from | RangeElement | Das Suchergebnis, von dem aus gesucht werden soll. |
Rückflug
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 mithilfe regulärer Ausdrücke im Inhalt des Elements nach dem angegebenen Textmuster.
Einige der JavaScript-Funktionen für reguläre Ausdrücke werden nicht vollständig unterstützt. Dazu gehören: Erfassungsgruppen und Modusmodifikatoren.
Das angegebene Muster des regulären Ausdrucks wird unabhängig mit jedem Textblock abgeglichen die im aktuellen Element enthalten sind.
Parameter
Name | Typ | Beschreibung |
---|---|---|
searchPattern | String | Muster, nach dem gesucht werden soll |
Rückflug
RangeElement
: ein Suchergebnis, das die Position des Suchtexts angibt, oder null, wenn kein
Übereinstimmung
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 im Inhalt des Elements nach dem angegebenen Textmuster, beginnend mit einem bestimmten in den Suchergebnissen.
Einige der JavaScript-Funktionen für reguläre Ausdrücke werden nicht vollständig unterstützt. Dazu gehören: Erfassungsgruppen und Modusmodifikatoren.
Das angegebene Muster des regulären Ausdrucks wird unabhängig mit jedem Textblock abgeglichen die im aktuellen Element enthalten sind.
Parameter
Name | Typ | Beschreibung |
---|---|---|
searchPattern | String | Muster, nach dem gesucht werden soll |
from | RangeElement | das Suchergebnis, in dem gesucht werden soll |
Rückflug
RangeElement
: ein Suchergebnis, das die nächste Position des Suchtexts angibt, oder null, wenn kein
Übereinstimmung
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 eine -Eigenschaft für jedes gültige Elementattribut enthält, wobei jeder
Eigenschaftsname entspricht einem Element in der DocumentApp.Attribute
-Aufzählung.
var doc = DocumentApp.getActiveDocument(); var documentTab = doc.getActiveTab().asDocumentTab(); var body = documentTab.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]); }
Rückflug
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.
Rückflug
String
: die Hintergrundfarbe im CSS-Format (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 im angegebenen untergeordneten Index ab.
var body = DocumentApp.getActiveDocument().getActiveTab().asDocumentTab().getBody(); // Obtain the first element in the tab. 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 | Der Index des abzurufenden untergeordneten Elements. |
Rückflug
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. |
Rückflug
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 den Spaltenbereich ab, also die Anzahl der Spalten von Tabellenzellen, die diese Zelle umfasst. Nicht zusammengeführte Zellen haben eine Spaltenspanne von 1.
Rückflug
Integer
: der Spaltenbereich oder 0 für eine Zelle, die durch eine andere 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.
Rückflug
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 dasselbe übergeordnete Element und folgt dem aktuellen Element.
Rückflug
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.
var 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
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.
Rückflug
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.
Rückflug
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.
Rückflug
Number
– der richtige 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
Rückflug
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.
Rückflug
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 die TableRow
mit dem aktuellen TableCell
ab.
Rückflug
TableRow
– die Tabellenzeile 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
getParentTable()
Ruft die Table
mit dem aktuellen TableCell
ab.
Rückflug
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 dasselbe übergeordnete Element und ist dem aktuellen Element vorangestellt.
Rückflug
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 Zeilenbereich ab, also die Anzahl der Zeilen von Tabellenzellen, die diese Zelle umfasst. Nicht zusammengeführt haben Zellen eine Zeilenspanne von 1.
Rückflug
Integer
– Zeilenbereich oder 0 für eine Zelle, die durch eine andere 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.
Rückflug
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
.
Rückflug
TextAlignment
– die Art der Textausrichtung oder null
, wenn der Text mehrere Arten von Text enthält
oder wenn die Textausrichtung noch nie
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 doc = DocumentApp.getActiveDocument(); var documentTab = doc.getActiveTab().asDocumentTab(); var body = documentTab.getBody(); // Obtain the first element in the active tab's 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.'); }
Rückflug
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.
Rückflug
VerticalAlignment
: 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.
Rückflug
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 eine neue HorizontalRule
und fügt sie im angegebenen Index ein.
Die horizontale Regel wird in einem neuen Paragraph
enthalten.
Parameter
Name | Typ | Beschreibung |
---|---|---|
childIndex | Integer | Index, an dem das Element eingefügt werden soll |
Rückflug
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 einen InlineImage
aus dem angegebenen Bild-BLOB am angegebenen
-Index.
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 |
Rückflug
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
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 | InlineImage | das einzufügende Bild |
Rückflug
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
im angegebenen Index ein.
Parameter
Name | Typ | Beschreibung |
---|---|---|
childIndex | Integer | Index, an dem das Element eingefügt werden soll |
listItem | ListItem | den einzufügenden Listeneintrag |
Rückflug
ListItem
– neuer 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 eine neue ListItem
und fügt sie im angegebenen Index ein.
Parameter
Name | Typ | Beschreibung |
---|---|---|
childIndex | Integer | Index, an dem das Element eingefügt werden soll |
text | String | Textinhalt |
Rückflug
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
im angegebenen Index ein.
Parameter
Name | Typ | Beschreibung |
---|---|---|
childIndex | Integer | Index, an dem das Element eingefügt werden soll |
paragraph | Paragraph | den einzufügenden Absatz. |
Rückflug
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 eine neue Paragraph
und fügt sie im angegebenen Index ein.
Parameter
Name | Typ | Beschreibung |
---|---|---|
childIndex | Integer | Index, an dem das Element eingefügt werden soll |
text | String | Textinhalt |
Rückflug
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 eine neue Table
und fügt sie im angegebenen Index ein.
Parameter
Name | Typ | Beschreibung |
---|---|---|
childIndex | Integer | Index, an dem das Element eingefügt werden soll |
Rückflug
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 eine neue Table
und fügt sie ein, die die angegebenen Zellen am angegebenen Index enthält.
Parameter
Name | Typ | Beschreibung |
---|---|---|
childIndex | Integer | 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
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
im angegebenen Index ein.
Parameter
Name | Typ | Beschreibung |
---|---|---|
childIndex | Integer | Index, an dem das Element eingefügt werden soll |
table | Table | die Tabelle, um sie einzufügen, |
Rückflug
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.
Rückflug
Boolean
: gibt an, ob sich das Element am Ende des Tabs 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 vorangehenden gleichgeordneten Element desselben Typs zusammen.
Nur Elemente derselben ElementType
können zusammengeführt werden. Alle untergeordneten Elemente, die in
werden zum vorherigen gleichgeordneten Element verschoben.
Das aktuelle Element wird aus dem Dokument entfernt.
var doc = DocumentApp.getActiveDocument(); var documentTab = doc.getActiveTab().asDocumentTab(); var body = documentTab.getBody(); // Example 1: Merge paragraphs // Append two paragraphs to the document's active tab. 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();
Rückflug
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, |
Rückflug
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 dem übergeordneten Element.
var doc = DocumentApp.getActiveDocument(); var documentTab = doc.getActiveTab().asDocumentTab() var body = documentTab.getBody(); // Remove all images in the active tab's body. var imgs = body.getImages(); for (var i = 0; i < imgs.length; i++) { imgs[i].removeFromParent(); }
Rückflug
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 durch einen bestimmten Ersatzstring, wobei die reguläre Ausdrücke.
Das Suchmuster wird als String übergeben, nicht als JavaScript-Objekt für reguläre Ausdrücke. Daher müssen Sie alle umgekehrten Schrägstriche im Muster mit Escapezeichen versehen.
Bei dieser Methode wird das reguläre RE2-Protokoll von Google Ausdrucksbibliothek, die die unterstützte Syntax einschränkt.
Das angegebene Muster des regulären Ausdrucks wird unabhängig mit jedem Textblock abgeglichen die im aktuellen Element enthalten sind.
var 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 |
---|---|---|
searchPattern | 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
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, in dem jeder Eigenschaftsname ein Element in
DocumentApp.Attribute
und jeder Attributwert ist der neue Wert,
angewendet.
var doc = DocumentApp.getActiveDocument(); var documentTab = doc.getActiveTab().asDocumentTab(); var body = documentTab.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. |
Rückflug
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)
Legt die Hintergrundfarbe fest.
Parameter
Name | Typ | Beschreibung |
---|---|---|
color | String | Hintergrundfarbe, formatiert in CSS-Notation (z. B. '#ffffff' ) |
Rückflug
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 |
Rückflug
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 | Abstand unten in Punkten |
Rückflug
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 | den linken Abstand in Punkten |
Rückflug
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 richtigen Abstand in Punkten fest.
Parameter
Name | Typ | Beschreibung |
---|---|---|
paddingRight | Number | Der richtige Abstand in Punkten |
Rückflug
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 | der obere Abstand in Punkten |
Rückflug
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 |
Rückflug
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 in the active tab be superscript. var documentTab = DocumentApp.getActiveDocument().getActiveTab().asDocumentTab(); var text = documentTab.getBody().getParagraphs()[0].editAsText(); text.setTextAlignment(DocumentApp.TextAlignment.SUPERSCRIPT);
Parameter
Name | Typ | Beschreibung |
---|---|---|
textAlignment | TextAlignment | Die Art der anzuwendenden Textausrichtung |
Rückflug
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 | vertikale Ausrichtung |
Rückflug
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 |
Rückflug
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