Class PositionedImage

PositioniertesBild

Bild mit fester Position, das an einer Paragraph verankert ist. Im Gegensatz zu einer InlineImage ist eine PositionedImage keine Element. Es hat kein übergeordnetes oder untergeordnetes Element. Stattdessen ist es an einem Paragraph oder ListItem verankert und wird über Abweichungen von diesem Anker platziert. Ein PositionedImage hat eine ID, mit der es referenziert werden kann. 

const body =
    DocumentApp.getActiveDocument().getActiveTab().asDocumentTab().getBody();

// Append a new paragraph.
const paragraph = body.appendParagraph('New paragraph to anchor the image to.');

// Get an image in Drive from its ID.
const image = DriveApp.getFileById('ENTER_IMAGE_FILE_ID_HERE').getBlob();

// Add the PositionedImage with offsets (in points).
const posImage =
    paragraph.addPositionedImage(image).setTopOffset(60).setLeftOffset(40);

Methoden

MethodeRückgabetypKurzbeschreibung
getAs(contentType)BlobGibt die Daten in diesem Objekt als Blob zurück, der in den angegebenen Inhaltstyp konvertiert wurde.
getBlob()BlobGibt die Daten in diesem Objekt als Blob zurück.
getHeight()IntegerDie Höhe des Bildes in Pixeln.
getId()StringRuft die ID des Bilds ab.
getLayout()PositionedLayoutErmittelt einen Enum-Wert, der angibt, wie das Bild angeordnet ist.
getLeftOffset()NumberDer Abstand des Bildes in Punkten vom linken Rand des Absatzes.
getParagraph()ParagraphRuft das Paragraph ab, an dem das Bild verankert ist.
getTopOffset()NumberDer Abstand des Bildes in Punkten vom oberen Rand des Absatzes.
getWidth()IntegerDie Breite des Bilds in Pixeln.
setHeight(height)PositionedImageHiermit wird die Höhe des Bildes in Pixeln festgelegt.
setLayout(layout)PositionedImageHier wird festgelegt, wie das Bild angeordnet wird.
setLeftOffset(offset)PositionedImageLegt den Abstand des Bildes in Punkten vom linken Rand des Absatzes fest.
setTopOffset(offset)PositionedImageLegt den Abstand des Bildes in Punkten vom oberen Rand des Absatzes fest.
setWidth(width)PositionedImageHiermit wird die Breite des Bilds in Pixeln festgelegt.

Detaillierte Dokumentation

getAs(contentType)

Gibt die Daten in diesem Objekt als Blob zurück, der in den angegebenen Inhaltstyp konvertiert wurde. Bei dieser Methode wird dem Dateinamen die entsprechende Erweiterung hinzugefügt, z. B. „meinedatei.pdf“. Es wird jedoch davon ausgegangen, dass der Teil des Dateinamens, der auf den letzten Punkt (falls vorhanden) folgt, eine vorhandene Erweiterung ist, die ersetzt werden soll. Daraus wird „Einkaufsliste.25.12.2014“ zu „Einkaufsliste.25.12.pdf“.

Die täglichen Kontingente 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. Bei Bildern im BMP-, GIF-, JPEG- oder PNG-Format sind auch 'image/bmp', 'image/gif', 'image/jpeg' oder 'image/png' zulässig. Für ein Google Docs-Dokument ist auch 'text/markdown' zulässig.

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

Die Höhe des Bildes in Pixeln.

Rückflug

Integer: Höhe des Bildes in Pixeln

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

  • https://www.googleapis.com/auth/documents.currentonly
  • https://www.googleapis.com/auth/documents

getId()

Ruft die ID des Bilds ab.

Rückflug

String: die Bild-ID

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

  • https://www.googleapis.com/auth/documents.currentonly
  • https://www.googleapis.com/auth/documents

getLayout()

Ermittelt einen Enum-Wert, der angibt, wie das Bild angeordnet ist.

Rückflug

PositionedLayout – das Bildlayout

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

  • https://www.googleapis.com/auth/documents.currentonly
  • https://www.googleapis.com/auth/documents

getLeftOffset()

Der Abstand des Bildes in Punkten vom linken Rand des Absatzes.

Rückflug

Number: der Abstand des Bildes zum linken Rand des linken Absatzes

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere 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.

Rückflug

Paragraph – der übergeordnete Absatz

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

  • https://www.googleapis.com/auth/documents.currentonly
  • https://www.googleapis.com/auth/documents

getTopOffset()

Der Abstand des Bildes in Punkten vom oberen Rand des Absatzes.

Rückflug

Number: der Bildabstand vom oberen Rand des linken Absatzes

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

  • https://www.googleapis.com/auth/documents.currentonly
  • https://www.googleapis.com/auth/documents

getWidth()

Die Breite des Bilds in Pixeln.

Rückflug

Integer: Die Breite des Bildes in Pixeln

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

  • https://www.googleapis.com/auth/documents.currentonly
  • https://www.googleapis.com/auth/documents

setHeight(height)

Hiermit wird die Höhe des Bildes in Pixeln festgelegt.

Parameter

NameTypBeschreibung
heightIntegerdie Höhe des Bildes in Pixeln

Rückflug

PositionedImage – das aktuelle Objekt

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

  • https://www.googleapis.com/auth/documents.currentonly
  • https://www.googleapis.com/auth/documents

setLayout(layout)

Hier wird festgelegt, wie das Bild angeordnet wird.

Parameter

NameTypBeschreibung
layoutPositionedLayoutein Enum, das den Layoutmodus darstellt

Rückflug

PositionedImage – dieses Objekt für die Verkettung

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

  • https://www.googleapis.com/auth/documents.currentonly
  • https://www.googleapis.com/auth/documents

setLeftOffset(offset)

Legt den Abstand des Bildes in Punkten vom linken Rand des Absatzes fest.

Parameter

NameTypBeschreibung
offsetNumberAbstand vom linken Rand des Absatzes

Rückflug

PositionedImage – dieses Objekt für die Verkettung

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

  • https://www.googleapis.com/auth/documents.currentonly
  • https://www.googleapis.com/auth/documents

setTopOffset(offset)

Legt den Abstand des Bildes in Punkten vom oberen Rand des Absatzes fest.

Parameter

NameTypBeschreibung
offsetNumbervom oberen Rand des Absatzes abweichen

Rückflug

PositionedImage – dieses Objekt für die Verkettung

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

  • https://www.googleapis.com/auth/documents.currentonly
  • https://www.googleapis.com/auth/documents

setWidth(width)

Hiermit wird die Breite des Bilds in Pixeln festgelegt.

Parameter

NameTypBeschreibung
widthIntegerdie Breite des Bildes in Pixeln

Rückflug

PositionedImage – das aktuelle Objekt

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

  • https://www.googleapis.com/auth/documents.currentonly
  • https://www.googleapis.com/auth/documents