Bild mit fester Position, verankert an Paragraph
. Im Gegensatz zu InlineImage
ist ein PositionedImage
und nicht vom Typ Element
. Es hat keine
das übergeordnete oder gleichgeordnete Element
-Element. Stattdessen
Sie ist in einem Paragraph
oder ListItem
verankert und wird über Offsets von
diesem Anker. Eine PositionedImage
hat eine ID, mit der auf sie verwiesen werden kann.
var body = DocumentApp.getActiveDocument().getActiveTab().asDocumentTab().getBody(); // Append a new paragraph. var paragraph = body.appendParagraph("New paragraph to anchor the image to."); // Get an image in Drive from its ID. var image = DriveApp.getFileById('ENTER_IMAGE_FILE_ID_HERE').getBlob(); // Add the PositionedImage with offsets (in points). var posImage = paragraph.addPositionedImage(image) .setTopOffset(60) .setLeftOffset(40);
Methoden
Methode | Rückgabetyp | Kurzbeschreibung |
---|---|---|
getAs(contentType) | Blob | Gibt die Daten in diesem Objekt als Blob zurück, das in den angegebenen Inhaltstyp konvertiert wurde. |
getBlob() | Blob | Gibt die Daten in diesem Objekt als Blob zurück. |
getHeight() | Integer | Ruft die Höhe des Bildes in Pixeln ab. |
getId() | String | Ruft die Image-ID ab. |
getLayout() | PositionedLayout | Ruft einen enum-Wert ab, der das Layout des Bildes darstellt. |
getLeftOffset() | Number | Ruft den Bildversatz in Punkten vom linken Absatzrand ab. |
getParagraph() | Paragraph | Ruft den Paragraph ab, an dem das Bild verankert ist. |
getTopOffset() | Number | Ruft den Versatz des Bildes in Punkten vom oberen Absatzrand ab. |
getWidth() | Integer | Ruft die Bildbreite in Pixeln ab. |
setHeight(height) | PositionedImage | Legt die Höhe des Bildes in Pixeln fest. |
setLayout(layout) | PositionedImage | Legt die Definition für das Layout des Bildes fest. |
setLeftOffset(offset) | PositionedImage | Legt den Bildversatz in Punkten vom linken Absatzrand fest |
setTopOffset(offset) | PositionedImage | Legt den Versatz des Bildes in Punkten vom oberen Absatzrand fest. |
setWidth(width) | PositionedImage | Legt die Breite des Bildes in Pixeln fest. |
Detaillierte Dokumentation
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.
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
getId()
Ruft die Image-ID ab.
Rückflug
String
– die Bild-ID
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
getLayout()
Ruft einen enum-Wert ab, der das Layout des Bildes darstellt.
Rückflug
PositionedLayout
– das Bildlayout
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
getLeftOffset()
Ruft den Bildversatz in Punkten vom linken Absatzrand ab.
Rückflug
Number
: der Bildversatz vom linken Absatzrand
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
getParagraph()
Ruft den Paragraph
ab, an dem das Bild verankert ist.
Rückflug
Paragraph
– übergeordneter 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
getTopOffset()
Ruft den Versatz des Bildes in Punkten vom oberen Absatzrand ab.
Rückflug
Number
: das Bild, das vom oberen Rand des linken Absatzes entfernt 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
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
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
PositionedImage
– 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
setLayout(layout)
Legt die Definition für das Layout des Bildes fest.
Parameter
Name | Typ | Beschreibung |
---|---|---|
layout | PositionedLayout | Eine Aufzählung, die den Layoutmodus darstellt |
Rückflug
PositionedImage
– dieses Objekt zur Verkettung
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
setLeftOffset(offset)
Legt den Bildversatz in Punkten vom linken Absatzrand fest
Parameter
Name | Typ | Beschreibung |
---|---|---|
offset | Number | Abstand zum linken Absatz |
Rückflug
PositionedImage
– dieses Objekt zur Verkettung
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
setTopOffset(offset)
Legt den Versatz des Bildes in Punkten vom oberen Absatzrand fest.
Parameter
Name | Typ | Beschreibung |
---|---|---|
offset | Number | Abstand zum oberen Absatzrand |
Rückflug
PositionedImage
– dieses Objekt zur Verkettung
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
PositionedImage
– 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