Class PositionedImage

PositionedImage

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

MethodeRückgabetypKurzbeschreibung
getAs(contentType)BlobGibt die Daten in diesem Objekt als Blob zurück, das in den angegebenen Inhaltstyp konvertiert wurde.
getBlob()BlobGibt die Daten in diesem Objekt als Blob zurück.
getHeight()IntegerRuft die Bildhöhe in Pixeln ab.
getId()StringRuft die Image-ID ab.
getLayout()PositionedLayoutRuft einen enum-Wert ab, der angibt, wie das Bild angeordnet ist.
getLeftOffset()NumberRuft den Abstand des Bilds in Punkten vom linken Absatz aus ab.
getParagraph()ParagraphRuft das Paragraph ab, an dem das Bild verankert ist.
getTopOffset()NumberRuft den Abstand des Bilds vom oberen Rand des Absatzes in Punkten ab.
getWidth()IntegerRuft die Bildbreite in Pixeln ab.
setHeight(height)PositionedImageLegt die Höhe des Bildes in Pixeln fest.
setLayout(layout)PositionedImageLegt die Definition für das Layout des Bildes fest.
setLeftOffset(offset)PositionedImageLegt den Abstand des Bilds in Punkten vom linken Absatz aus fest.
setTopOffset(offset)PositionedImageLegt den Abstand des Bilds vom oberen Rand des Absatzes in Punkten fest.
setWidth(width)PositionedImageLegt 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

NameTypBeschreibung
contentTypeStringDer 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()

Gibt die Daten in diesem Objekt als Blob zurück.

Return

Blob: Die Daten als Blob.


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

NameTypBeschreibung
heightIntegerDie 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

NameTypBeschreibung
layoutPositionedLayouteinen 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

NameTypBeschreibung
offsetNumberAbstand 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

NameTypBeschreibung
offsetNumberAbstand 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

NameTypBeschreibung
widthIntegerDie 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