Ein Element, das ein eingebettetes Bild darstellt. Ein InlineImage
kann in einem
ListItem
oder Paragraph
, es sei denn, ListItem
oder Paragraph
befinden sich innerhalb
FootnoteSection
. Ein InlineImage
selbst kann kein anderes Element enthalten. Für
Weitere Informationen zur Dokumentstruktur finden Sie im Leitfaden zum Erweitern von Google Docs.
Methoden
Methode | Rückgabetyp | Kurzbeschreibung |
---|---|---|
copy() | InlineImage | Gibt eine losgelöste, tiefe Kopie des aktuellen Elements zurück. |
getAltDescription() | String | Gibt die alternative Beschreibung des Bilds zurück. |
getAltTitle() | String | Gibt den alternativen Titel des Bilds zurück. |
getAs(contentType) | Blob | Gibt die Daten in diesem Objekt als Blob zurück, das in den angegebenen Inhaltstyp konvertiert wurde. |
getAttributes() | Object | Ruft die Attribute des Elements ab. |
getBlob() | Blob | Gibt die Daten in diesem Objekt als Blob zurück. |
getHeight() | Integer | Ruft die Höhe des Bildes in Pixeln ab. |
getLinkUrl() | String | Ruft die Link-URL ab. |
getNextSibling() | Element | Ruft das nächste gleichgeordnete Element des Elements ab |
getParent() | ContainerElement | Ruft das übergeordnete Element des Elements ab. |
getPreviousSibling() | Element | Ruft das vorherige gleichgeordnete Element des Elements ab |
getType() | ElementType | Ruft den ElementType des Elements ab. |
getWidth() | Integer | Ruft die Bildbreite in Pixeln ab. |
isAtDocumentEnd() | Boolean | Bestimmt, ob sich das Element am Ende von Document befindet. |
merge() | InlineImage | Führt das Element mit dem vorangehenden gleichgeordneten Element desselben Typs zusammen. |
removeFromParent() | InlineImage | Entfernt das Element aus dem übergeordneten Element. |
setAltDescription(description) | InlineImage | Legt die alternative Beschreibung des Bilds fest. |
setAltTitle(title) | InlineImage | Legt den alternativen Titel des Bilds fest. |
setAttributes(attributes) | InlineImage | Legt die Attribute des Elements fest. |
setHeight(height) | InlineImage | Legt die Höhe des Bildes in Pixeln fest. |
setLinkUrl(url) | InlineImage | Legt die Link-URL fest. |
setWidth(width) | InlineImage | Legt die Breite des Bildes in Pixeln fest. |
Detaillierte Dokumentation
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
InlineImage
: 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
getAltDescription()
Gibt die alternative Beschreibung des Bilds zurück.
Rückflug
String
: der alternative Titel oder null
, wenn das Element keinen alternativen Titel hat
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
getAltTitle()
Gibt den alternativen Titel des Bilds zurück.
Rückflug
String
: der alternative Titel oder null
, wenn das Element keinen alternativen Titel hat
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
getAs(contentType)
Gibt die Daten in diesem Objekt als Blob zurück, das in den angegebenen Inhaltstyp konvertiert wurde. Dieses fügt dem Dateinamen die entsprechende Erweiterung hinzu, beispielsweise "meinedatei.pdf". Allerdings geht davon aus, dass der Teil des Dateinamens, der auf den letzten Punkt folgt (falls vorhanden), ein vorhandener die ersetzt werden soll. Daher lautet „Einkaufsliste.12.25.2014“. wird zu „Einkaufsliste.12.25.pdf“.
Die Tageskontingente für Conversions finden Sie unter Kontingente für Google Dienste. Neu erstellte Google Workspace-Domains unterliegen möglicherweise vorübergehend strengeren Richtlinien. Kontingenten.
Parameter
Name | Typ | Beschreibung |
---|---|---|
contentType | String | Der MIME-Typ, in den konvertiert werden soll. Für die meisten Blobs ist 'application/pdf'
ist die einzige gültige Option. Für Bilder im BMP-, GIF-, JPEG- oder PNG-Format gilt auch Folgendes: 'image/bmp' , 'image/gif' , 'image/jpeg' oder 'image/png'
gültig sein. Bei einem Google Docs-Dokument ist 'text/markdown' ebenfalls gültig. |
Rückflug
Blob
: Die Daten als Blob.
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
getBlob()
Gibt die Daten in diesem Objekt als Blob zurück.
Rückflug
Blob
: Die Daten als Blob.
getHeight()
Ruft die Höhe des Bildes in Pixeln ab.
Rückflug
Integer
: die Höhe des Bildes in Pixeln
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
.
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
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
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
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
getWidth()
Ruft die Bildbreite in Pixeln ab.
Rückflug
Integer
– die Breite des Bildes in Pixeln
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
InlineImage
: 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
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
InlineImage
: 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
setAltDescription(description)
Legt die alternative Beschreibung des Bilds fest. Wenn der angegebene Titel null
lautet, wird der Wert für
description in den leeren String ein.
Parameter
Name | Typ | Beschreibung |
---|---|---|
description | String | der alternative Titel |
Rückflug
InlineImage
– das aktuelle Objekt
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
setAltTitle(title)
Legt den alternativen Titel des Bilds fest. Wenn der angegebene Titel null
ist, wird der Titel auf den
Leerer String.
Parameter
Name | Typ | Beschreibung |
---|---|---|
title | String | der alternative Titel |
Rückflug
InlineImage
– das aktuelle Objekt
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
InlineImage
: 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
setHeight(height)
Legt die Höhe des Bildes in Pixeln fest.
Parameter
Name | Typ | Beschreibung |
---|---|---|
height | Integer | Die Höhe des Bildes in Pixeln |
Rückflug
InlineImage
– das aktuelle Objekt
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. Wenn die angegebene URL null
oder ein leerer String ist, erstellt diese Methode
Link mit einer leeren URL, die möglicherweise als „Ungültiger Link“ angezeigt wird in Google Docs.
Parameter
Name | Typ | Beschreibung |
---|---|---|
url | String | Die Link-URL |
Rückflug
InlineImage
– das aktuelle Objekt
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 des Bildes in Pixeln fest.
Parameter
Name | Typ | Beschreibung |
---|---|---|
width | Integer | die Breite des Bildes in Pixeln |
Rückflug
InlineImage
– das aktuelle Objekt
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