Bild mit fester Position, verankert an Paragraph
Im Gegensatz zu InlineImage
ist PositionedImage
keine Element
. Sie hat kein übergeordnetes oder gleichgeordnetes Element
. Stattdessen ist sie mit einem Paragraph
oder ListItem
verankert und über Offsets von diesem Anker aus platziert. Ein PositionedImage
hat eine ID, mit der darauf verwiesen werden kann.
var body = DocumentApp.getActiveDocument().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 Bildhöhe in Pixeln ab. |
getId() | String | Ruft die Image-ID ab. |
getLayout() | PositionedLayout | Ruft einen enum-Wert ab, der angibt, wie das Bild angeordnet ist. |
getLeftOffset() | Number | Ruft den Abstand des Bilds in Punkten vom linken Absatz aus ab. |
getParagraph() | Paragraph | Ruft das Paragraph ab, an dem das Bild verankert ist. |
getTopOffset() | Number | Ruft den Abstand des Bilds vom oberen Rand des Absatzes in Punkten 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 Abstand des Bilds in Punkten vom linken Absatz aus fest. |
setTopOffset(offset) | PositionedImage | Legt den Abstand des Bilds vom oberen Rand des Absatzes in Punkten 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. Bei dieser Methode wird dem Dateinamen die entsprechende Erweiterung hinzugefügt, z. B. "myfile.pdf". Dabei wird jedoch davon ausgegangen, dass der Teil des Dateinamens, der auf den letzten Punkt (falls vorhanden) folgt, eine vorhandene Erweiterung ist, die ersetzt werden sollte. Aus „ShoppingList.12.25.2014“ wird dann „ShoppingList.12.25.pdf“.
Informationen zu den Tageskontingenten für Conversions finden Sie unter Kontingente für Google-Dienste. Für neu erstellte Google Workspace-Domains gelten möglicherweise vorübergehend strengere Kontingente.
Parameter
Name | Typ | Beschreibung |
---|---|---|
contentType | String | Der MIME-Typ, in den konvertiert werden soll. Für die meisten Blobs ist 'application/pdf' die einzige gültige Option. Für Bilder im BMP-, GIF-, JPEG- oder PNG-Format sind auch 'image/bmp' , 'image/gif' , 'image/jpeg' oder 'image/png' gültig. |
Return
Blob
: Die Daten als Blob.
getBlob()
getHeight()
Ruft die Bildhöhe in Pixeln ab.
Return
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.
Return
String
: die Image-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 angibt, wie das Bild angeordnet ist.
Return
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 Abstand des Bilds in Punkten vom linken Absatz aus ab.
Return
Number
: 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 das Paragraph
ab, an dem das Bild verankert ist.
Return
Paragraph
– der übergeordnete 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 Abstand des Bilds vom oberen Rand des Absatzes in Punkten ab.
Return
Number
: Bildversatz vom oberen Rand des linken Absatzes
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.
Return
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 |
Return
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 | einen Enum-Wert, der den Layoutmodus darstellt |
Return
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 Abstand des Bilds in Punkten vom linken Absatz aus fest.
Parameter
Name | Typ | Beschreibung |
---|---|---|
offset | Number | Abstand vom linken Absatzrand |
Return
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 Abstand des Bilds vom oberen Rand des Absatzes in Punkten fest.
Parameter
Name | Typ | Beschreibung |
---|---|---|
offset | Number | Abstand vom oberen Absatzrand |
Return
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 |
Return
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