Class PositionedImage

PositionedImage

Bild mit fester Position, das an einem Paragraph verankert ist. Im Gegensatz zu einem InlineImage-Objekt ist ein PositionedImage-Objekt kein Element-Objekt. Es hat kein übergeordnetes oder gleichgeordnetes Element. Stattdessen wird sie an einem Paragraph oder ListItem verankert und über Offsets von diesem Anker aus platziert. Ein PositionedImage hat eine ID, mit der darauf verwiesen 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, das in den angegebenen Inhaltstyp konvertiert wurde.
getBlob()BlobGibt die Daten in diesem Objekt als Blob zurück.
getHeight()IntegerRuft die Höhe des Bildes in Pixeln ab.
getId()StringRuft die ID des Bildes ab.
getLayout()PositionedLayoutRuft einen Enumerationswert ab, der angibt, wie das Bild angeordnet ist.
getLeftOffset()NumberRuft den Abstand des Bildes vom linken Rand des Absatzes in Punkten ab.
getParagraph()ParagraphRuft das Paragraph ab, an dem das Bild verankert ist.
getTopOffset()NumberRuft den Abstand des Bildes in Punkten vom oberen Rand des Absatzes ab.
getWidth()IntegerRuft die Breite des Bildes in Pixeln ab.
setHeight(height)PositionedImageLegt die Höhe des Bildes in Pixeln fest.
setLayout(layout)PositionedImageLegt die Definition für die Anordnung des Bildes fest.
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)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. Mit dieser Methode wird dem Dateinamen die entsprechende Erweiterung hinzugefügt, z. B. „meine_datei.pdf“. Dabei wird jedoch davon ausgegangen, dass der Teil des Dateinamens, der auf den letzten Punkt folgt (falls vorhanden), eine vorhandene Erweiterung ist, die ersetzt werden soll. Folglich wird aus „ShoppingList.12.25.2014“ „ShoppingList.12.25.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. Für Bilder im BMP-, GIF-, JPEG- oder PNG-Format sind auch 'image/bmp', 'image/gif', 'image/jpeg' oder 'image/png' gültig. Für ein Google Docs-Dokument ist auch 'text/markdown' 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

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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

getId()

Ruft die ID des Bildes ab.

Rückflug

String: die Bild-ID

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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

getLayout()

Ruft einen Enumerationswert ab, der angibt, wie das Bild angeordnet ist.

Rückflug

PositionedLayout – das Bildlayout

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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

getLeftOffset()

Ruft den Abstand des Bildes vom linken Rand des Absatzes in Punkten ab.

Rückflug

Number: Der Bild-Offset vom linken Rand des linken Absatzes

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

  • 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, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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

getTopOffset()

Ruft den Abstand des Bildes in Punkten vom oberen Rand des Absatzes ab.

Rückflug

Number: Der Bild-Offset vom oberen Rand des linken Absatzes

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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

getWidth()

Ruft die Breite des Bildes in Pixeln ab.

Rückflug

Integer: die Breite des Bildes in Pixeln

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

  • 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

Rückflug

PositionedImage – das aktuelle Objekt

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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

setLayout(layout)

Legt die Definition für die Anordnung des Bildes fest.

Parameter

NameTypBeschreibung
layoutPositionedLayoutEin Enum-Wert, der den Layoutmodus darstellt

Rückflug

PositionedImage – dieses Objekt für die Verkettung

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

  • 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, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

  • 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
offsetNumberAbstand vom oberen Rand des Absatzes

Rückflug

PositionedImage – dieses Objekt für die Verkettung

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

  • 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

Rückflug

PositionedImage – das aktuelle Objekt

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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