Diese Seite wurde von der Cloud Translation API übersetzt.

Class Image

Ein PageElement, das ein Bild darstellt.

Methoden

Methode	Rückgabetyp	Kurzbeschreibung
`alignOnPage(alignmentPosition)`	`Image`	Das Element wird an der angegebenen Ausrichtungsposition auf der Seite ausgerichtet.
`bringForward()`	`Image`	Verschiebt das Seitenelement auf der Seite um ein Element nach vorne.
`bringToFront()`	`Image`	Das Seitenelement wird an den Anfang der Seite verschoben.
`duplicate()`	`PageElement`	Das Seitenelement wird dupliziert.
`getAs(contentType)`	`Blob`	Gibt die Daten in diesem Objekt als Blob zurück, der in den angegebenen Inhaltstyp konvertiert wurde.
`getBlob()`	`Blob`	Gibt die Daten in diesem Bild als Blob zurück.
`getBorder()`	`Border`	Gibt die `Border` des Bilds zurück.
`getConnectionSites()`	`ConnectionSite[]`	Gibt die Liste der `ConnectionSite`s im Seitenelement zurück oder eine leere Liste, wenn das Seitenelement keine Verbindungsstellen hat.
`getContentUrl()`	`String`	Ruft eine URL zum Bild ab.
`getDescription()`	`String`	Gibt die Alt-Text-Beschreibung des Seitenelements zurück.
`getHeight()`	`Number`	Die Höhe des Elements in Punkten. Das ist die Höhe des Begrenzungsrahmens des Elements, wenn es nicht gedreht ist.
`getInherentHeight()`	`Number`	Gibt die Höhe des Elements in Punkten zurück.
`getInherentWidth()`	`Number`	Gibt die Breite des Elements in Punkten zurück.
`getLeft()`	`Number`	Gibt die horizontale Position des Elements in Punkten zurück, gemessen von der linken oberen Ecke der Seite, wenn das Element nicht gedreht ist.
`getLink()`	`Link`	Gibt `Link` oder `null` zurück, wenn kein Link vorhanden ist.
`getObjectId()`	`String`	Die eindeutige ID für dieses Objekt.
`getPageElementType()`	`PageElementType`	Gibt den Typ des Seitenelements als `PageElementType`-Enum zurück.
`getParentGroup()`	`Group`	Gibt die Gruppe zurück, zu der dieses Seitenelement gehört, oder `null`, wenn das Element keiner Gruppe zugewiesen ist.
`getParentPage()`	`Page`	Gibt die Seite zurück, auf der sich dieses Seitenelement befindet.
`getParentPlaceholder()`	`PageElement`	Gibt das übergeordnete Seitenelement des Platzhalters zurück.
`getPlaceholderIndex()`	`Integer`	Gibt den Index des Platzhalterbilds zurück.
`getPlaceholderType()`	`PlaceholderType`	Gibt den Platzhaltertyp des Bilds zurück oder `PlaceholderType.NONE`, wenn die Form kein Platzhalter ist.
`getRotation()`	`Number`	Gibt den Drehwinkel des Elements im Uhrzeigersinn um seine Mitte in Grad zurück. Null Grad bedeutet, dass das Element nicht gedreht wird.
`getSourceUrl()`	`String`	Die Quell-URL des Bilds, falls verfügbar.
`getTitle()`	`String`	Gibt den Titel des Alt-Texts des Seitenelements zurück.
`getTop()`	`Number`	Die vertikale Position des Elements in Punkten, gemessen von der oberen linken Ecke der Seite, wenn das Element nicht gedreht ist.
`getTransform()`	`AffineTransform`	Gibt die Transformation des Seitenelements zurück.
`getWidth()`	`Number`	Gibt die Breite des Elements in Punkten zurück. Das ist die Breite des Begrenzungsrahmens des Elements, wenn es nicht gedreht ist.
`preconcatenateTransform(transform)`	`Image`	Die angegebene Transformation wird mit der vorhandenen Transformation des Seitenelements vorkonkateniert.
`remove()`	`void`	Entfernt das Seitenelement.
`removeLink()`	`void`	Entfernt einen `Link`.
`replace(blobSource)`	`Image`	Ersetzt dieses Bild durch ein Bild, das durch ein `BlobSource`-Objekt beschrieben wird.
`replace(blobSource, crop)`	`Image`	Ersetzt dieses Bild durch ein Bild, das durch ein `Image`-Objekt beschrieben wird. Optional wird das Bild zugeschnitten.
`replace(imageUrl)`	`Image`	Ersetzt dieses Bild durch ein anderes Bild, das von der angegebenen URL heruntergeladen wird.
`replace(imageUrl, crop)`	`Image`	Ersetzt dieses Bild durch ein anderes Bild, das von der angegebenen URL heruntergeladen wird. Optional kann das Bild zugeschnitten werden.
`scaleHeight(ratio)`	`Image`	Die Höhe des Elements wird mit dem angegebenen Verhältnis skaliert.
`scaleWidth(ratio)`	`Image`	Die Breite des Elements wird mit dem angegebenen Verhältnis skaliert.
`select()`	`void`	Wählt nur die `PageElement` in der aktiven Präsentation aus und entfernt alle vorherigen Auswahlen.
`select(replace)`	`void`	Wählt das `PageElement` in der aktiven Präsentation aus.
`sendBackward()`	`Image`	Versetzt das Seitenelement auf der Seite um ein Element zurück.
`sendToBack()`	`Image`	Versetzt das Seitenelement ans Ende der Seite.
`setDescription(description)`	`Image`	Hiermit wird die Alt-Text-Beschreibung des Seitenelements festgelegt.
`setHeight(height)`	`Image`	Hiermit wird die Höhe des Elements in Punkten festgelegt. Das ist die Höhe des Begrenzungsrahmens des Elements, wenn es nicht gedreht ist.
`setLeft(left)`	`Image`	Legt die horizontale Position des Elements in Punkten fest, gemessen von der linken oberen Ecke der Seite, wenn das Element nicht gedreht ist.
`setLinkSlide(slideIndex)`	`Link`	Legt mit dem nullbasierten Index der Folie eine `Link` für die angegebene `Slide` fest.
`setLinkSlide(slide)`	`Link`	Hier wird eine `Link` auf die angegebene `Slide` festgelegt. Der Link wird anhand der angegebenen Folien-ID festgelegt.
`setLinkSlide(slidePosition)`	`Link`	Legt mithilfe der relativen Position der Folie einen `Link` für die angegebene `Slide` fest.
`setLinkUrl(url)`	`Link`	Legt einen `Link` für den angegebenen nicht leeren URL-String fest.
`setRotation(angle)`	`Image`	Legt den Drehwinkel des Elements im Uhrzeigersinn um seine Mitte in Grad fest.
`setTitle(title)`	`Image`	Hiermit wird der Titel des Alt-Texts für das Seitenelement festgelegt.
`setTop(top)`	`Image`	Legt die vertikale Position des Elements in Punkten fest, gemessen von der linken oberen Ecke der Seite, wenn das Element nicht gedreht ist.
`setTransform(transform)`	`Image`	Legt die Transformation des Seitenelements mit der angegebenen Transformation fest.
`setWidth(width)`	`Image`	Hiermit wird die Breite des Elements in Punkten festgelegt. Das ist die Breite des Begrenzungsrahmens des Elements, wenn es nicht gedreht ist.

Detaillierte Dokumentation

`alignOnPage(alignmentPosition)`

Das Element wird an der angegebenen Ausrichtungsposition auf der Seite ausgerichtet.

Parameter

Name	Typ	Beschreibung
`alignmentPosition`	`AlignmentPosition`	Die Position, an der dieses Seitenelement auf der Seite ausgerichtet werden soll.

Rückflug

Image – dieses Seitenelement zur Verkettung

`bringForward()`

Verschiebt das Seitenelement auf der Seite um ein Element nach vorne.

Das Seitenelement darf sich nicht in einer Gruppe befinden.

Rückflug

Image – dieses Seitenelement zur Verkettung

Autorisierung

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

https://www.googleapis.com/auth/presentations.currentonly
https://www.googleapis.com/auth/presentations

`bringToFront()`

Das Seitenelement wird an den Anfang der Seite verschoben.

Das Seitenelement darf sich nicht in einer Gruppe befinden.

Rückflug

Image – dieses Seitenelement zur Verkettung

Autorisierung

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

https://www.googleapis.com/auth/presentations.currentonly
https://www.googleapis.com/auth/presentations

`duplicate()`

Das Seitenelement wird dupliziert.

Das duplizierte Seitenelement wird auf derselben Seite an derselben Position wie das Original platziert.

Rückflug

PageElement: Das neue Duplikat dieses Seitenelements.

Autorisierung

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

https://www.googleapis.com/auth/presentations.currentonly
https://www.googleapis.com/auth/presentations

`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

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. 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 Bild als Blob zurück.

Rückflug

Blob – die Bilddaten als Blob.

`getBorder()`

Gibt die Border des Bilds zurück.

Rückflug

Border: Der Rahmen des Bilds.

Autorisierung

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

https://www.googleapis.com/auth/presentations.currentonly
https://www.googleapis.com/auth/presentations

`getConnectionSites()`

Gibt die Liste der ConnectionSites im Seitenelement zurück oder eine leere Liste, wenn das Seitenelement keine Verbindungsstellen hat.

Rückflug

ConnectionSite[]: Liste der Verbindungsstellen. Diese Liste kann leer sein, wenn dieses Element keine Verbindungsstellen hat.

Autorisierung

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

https://www.googleapis.com/auth/presentations.currentonly
https://www.googleapis.com/auth/presentations

`getContentUrl()`

Ruft eine URL zum Bild ab.

Diese URL ist mit dem Konto des Anfragenden getaggt. Jeder, der die URL hat, kann also auf das Bild zugreifen, als wäre er der ursprüngliche Anfragende. Der Zugriff auf das Bild kann verloren gehen, wenn sich die Freigabeeinstellungen der Präsentation ändern. Die zurückgegebene URL läuft nach kurzer Zeit ab.

Rückflug

String

Autorisierung

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

https://www.googleapis.com/auth/presentations.currentonly
https://www.googleapis.com/auth/presentations

`getDescription()`

Gibt die Alt-Text-Beschreibung des Seitenelements zurück. Die Beschreibung wird mit dem Titel kombiniert, um den Alt-Text anzuzeigen und vorzulesen.

Rückflug

String: Die Alt-Text-Beschreibung des Seitenelements.

Autorisierung

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

https://www.googleapis.com/auth/presentations.currentonly
https://www.googleapis.com/auth/presentations

`getHeight()`

Die Höhe des Elements in Punkten. Das ist die Höhe des Begrenzungsrahmens des Elements, wenn es nicht gedreht ist.

Diese Methode ist nicht mit allen Seitenelementen kompatibel. Informationen dazu, welche Seitenelemente mit dieser Methode nicht kompatibel sind, finden Sie unter Einschränkungen bei Größe und Positionierung.

Rückflug

Number: Die Höhe des Seitenelements in Punkten oder null, wenn das Seitenelement keine Höhe hat.

Autorisierung

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

https://www.googleapis.com/auth/presentations.currentonly
https://www.googleapis.com/auth/presentations

`getInherentHeight()`

Gibt die Höhe des Elements in Punkten zurück.

Die Transformation des Seitenelements ist relativ zu seiner ursprünglichen Größe. Verwenden Sie die natürliche Größe in Verbindung mit der Transformation des Elements, um das endgültige Erscheinungsbild des Elements zu bestimmen.

Rückflug

Number: Die Höhe des Seitenelements in Punkten oder null, wenn das Seitenelement keine Höhe hat.

Autorisierung

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

https://www.googleapis.com/auth/presentations.currentonly
https://www.googleapis.com/auth/presentations

`getInherentWidth()`

Gibt die Breite des Elements in Punkten zurück.

Rückflug

Number: Die Breite des Seitenelements in Punkten oder null, wenn das Seitenelement keine Breite hat.

Autorisierung

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

https://www.googleapis.com/auth/presentations.currentonly
https://www.googleapis.com/auth/presentations

`getLeft()`

Gibt die horizontale Position des Elements in Punkten zurück, gemessen von der linken oberen Ecke der Seite, wenn das Element nicht gedreht ist.

Rückflug

Number: Die horizontale Position dieses Elements in Punkten, ausgehend von der linken oberen Ecke der Seite.

Autorisierung

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

https://www.googleapis.com/auth/presentations.currentonly
https://www.googleapis.com/auth/presentations

`getLink()`

Gibt Link oder null zurück, wenn kein Link vorhanden ist.

const shape = SlidesApp.getActivePresentation().getSlides()[0].getShapes()[0];
const link = shape.getLink();
if (link != null) {
  Logger.log(`Shape has a link of type: ${link.getLinkType()}`);
}

Rückflug

Link: Der Link oder null, wenn kein Link vorhanden ist.

Autorisierung

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

https://www.googleapis.com/auth/presentations.currentonly
https://www.googleapis.com/auth/presentations

`getObjectId()`

Die eindeutige ID für dieses Objekt. Die Objekt-IDs, die von Seiten und Seitenelementen verwendet werden, haben denselben Namespace.

Rückflug

String: Die eindeutige ID für dieses Objekt.

Autorisierung

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

https://www.googleapis.com/auth/presentations.currentonly
https://www.googleapis.com/auth/presentations

`getPageElementType()`

Gibt den Typ des Seitenelements als PageElementType-Enum zurück.

Rückflug

PageElementType: Der Typ des Seitenelements.

Autorisierung

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

https://www.googleapis.com/auth/presentations.currentonly
https://www.googleapis.com/auth/presentations

`getParentGroup()`

Gibt die Gruppe zurück, zu der dieses Seitenelement gehört, oder null, wenn das Element keiner Gruppe zugewiesen ist.

Rückflug

Group: Die Gruppe, zu der dieses Seitenelement gehört, oder null.

Autorisierung

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

https://www.googleapis.com/auth/presentations.currentonly
https://www.googleapis.com/auth/presentations

`getParentPage()`

Gibt die Seite zurück, auf der sich dieses Seitenelement befindet.

Rückflug

Page: Die Seite, auf der sich dieses Element befindet.

Autorisierung

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

https://www.googleapis.com/auth/presentations.currentonly
https://www.googleapis.com/auth/presentations

`getParentPlaceholder()`

Gibt das übergeordnete Seitenelement des Platzhalters zurück. Gibt null zurück, wenn das Bild kein Platzhalter ist oder kein übergeordnetes Element hat.

Rückflug

PageElement: Das übergeordnete Seitenelement dieses Bild-Platzhalters oder null, wenn dieses Bild kein Platzhalter ist oder kein übergeordnetes Element hat.

Autorisierung

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

https://www.googleapis.com/auth/presentations.currentonly
https://www.googleapis.com/auth/presentations

`getPlaceholderIndex()`

Gibt den Index des Platzhalterbilds zurück. Wenn zwei oder mehr Platzhalterbilder auf derselben Seite vom selben Typ sind, haben sie jeweils einen eindeutigen Indexwert. Gibt null zurück, wenn das Bild kein Platzhalter ist.

Rückflug

Integer: Platzhalterindex dieses Bildes oder null, wenn es sich nicht um einen Platzhalter handelt.

Autorisierung

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

https://www.googleapis.com/auth/presentations.currentonly
https://www.googleapis.com/auth/presentations

`getPlaceholderType()`

Gibt den Platzhaltertyp des Bilds zurück oder PlaceholderType.NONE, wenn die Form kein Platzhalter ist.

Rückflug

PlaceholderType: Der Platzhaltertyp dieses Bilds.

Autorisierung

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

https://www.googleapis.com/auth/presentations.currentonly
https://www.googleapis.com/auth/presentations

`getRotation()`

Gibt den Drehwinkel des Elements im Uhrzeigersinn um seine Mitte in Grad zurück. Null Grad bedeutet, dass das Element nicht gedreht wird.

Rückflug

Number: Der Drehwinkel in Grad zwischen 0 (inklusive) und 360 (exklusiv).

Autorisierung

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

https://www.googleapis.com/auth/presentations.currentonly
https://www.googleapis.com/auth/presentations

`getSourceUrl()`

Die Quell-URL des Bilds, falls verfügbar.

Wenn ein Bild per URL eingefügt wird, wird die beim Einfügen des Bilds angegebene URL zurückgegeben.

Rückflug

String: Die Bild-URL oder null, wenn das Bild keine Quell-URL hat.

Autorisierung

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

https://www.googleapis.com/auth/presentations.currentonly
https://www.googleapis.com/auth/presentations

`getTitle()`

Gibt den Titel des Alt-Texts des Seitenelements zurück. Der Titel wird mit der Beschreibung kombiniert, um den Alt-Text anzuzeigen und vorzulesen.

Rückflug

String: Der Titel des Alt-Texts des Seitenelements.

Autorisierung

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

https://www.googleapis.com/auth/presentations.currentonly
https://www.googleapis.com/auth/presentations

`getTop()`

Die vertikale Position des Elements in Punkten, gemessen von der oberen linken Ecke der Seite, wenn das Element nicht gedreht ist.

Rückflug

Number: Die vertikale Position dieses Elements in Punkten, ausgehend von der linken oberen Ecke der Seite.

Autorisierung

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

https://www.googleapis.com/auth/presentations.currentonly
https://www.googleapis.com/auth/presentations

`getTransform()`

Gibt die Transformation des Seitenelements zurück.

Das visuelle Erscheinungsbild des Seitenelements wird durch seine absolute Transformation bestimmt. Um die absolute Transformation zu berechnen, müssen Sie die Transformation eines Seitenelements mit den Transformationen aller übergeordneten Gruppen vorkonkatenieren. Wenn sich das Seitenelement nicht in einer Gruppe befindet, entspricht seine absolute Transformation dem Wert in diesem Feld.

Rückflug

AffineTransform: Die Transformation des Seitenelements.

Autorisierung

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

https://www.googleapis.com/auth/presentations.currentonly
https://www.googleapis.com/auth/presentations

`getWidth()`

Gibt die Breite des Elements in Punkten zurück. Das ist die Breite des Begrenzungsrahmens des Elements, wenn es nicht gedreht ist.

Rückflug

Number: Die Breite des Seitenelements in Punkten oder null, wenn das Seitenelement keine Breite hat.

Autorisierung

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

https://www.googleapis.com/auth/presentations.currentonly
https://www.googleapis.com/auth/presentations

`preconcatenateTransform(transform)`

Die angegebene Transformation wird mit der vorhandenen Transformation des Seitenelements vorkonkateniert.

newTransform = argument * existingTransform;

So verschieben Sie ein Seitenelement beispielsweise um 36 Punkte nach links:

const element = SlidesApp.getActivePresentation().getSlides()[0].getPageElements()[0];
element.preconcatenateTransform(
    SlidesApp.newAffineTransformBuilder().setTranslateX(-36.0).build(),
);

Sie können die Transformation des Seitenelements auch durch setTransform(transform) ersetzen.

Parameter

Name	Typ	Beschreibung
`transform`	`AffineTransform`	Die Transformation, die vor der Transformation dieses Seitenelements vorkonkateniert werden soll.

Rückflug

Image – dieses Seitenelement zur Verkettung

Autorisierung

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

https://www.googleapis.com/auth/presentations.currentonly
https://www.googleapis.com/auth/presentations

`remove()`

Entfernt das Seitenelement.

Wenn eine Group nach dem Entfernen nur noch ein oder gar keine Seitenelemente enthält, wird auch die Gruppe selbst entfernt.

Wenn ein Platzhalter PageElement in einem Master oder Layout entfernt wird, werden auch alle leeren vererbten Platzhalter entfernt.

Autorisierung

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

https://www.googleapis.com/auth/presentations.currentonly
https://www.googleapis.com/auth/presentations

`removeLink()`

Entfernt einen Link.

const slides = SlidesApp.getActivePresentation().getSlides();
slides[1].getShapes()[0].removeLink();

`replace(blobSource)`

Ersetzt dieses Bild durch ein Bild, das durch ein BlobSource-Objekt beschrieben wird.

Wenn Sie das Bild einfügen, wird es einmal aus BlobSource abgerufen und eine Kopie wird zur Anzeige in der Präsentation gespeichert. Bilder dürfen nicht größer als 50 MB und nicht mehr als 25 Megapixel haben. Sie müssen im PNG-, JPEG- oder GIF-Format vorliegen.

Um das Seitenverhältnis des Bildes beizubehalten, wird es skaliert und anhand der Größe des vorhandenen Bildes zentriert.

const image = SlidesApp.getActivePresentation().getSlides()[0].getImages()[0];
// Get the Drive image file with the given ID.
const driveImage = DriveApp.getFileById("123abc");
image.replace(driveImage);

Parameter

Name	Typ	Beschreibung
`blobSource`	`BlobSource`	Die Bilddaten.

Rückflug

Image – Diese Image nach dem Austausch.

Autorisierung

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

https://www.googleapis.com/auth/presentations.currentonly
https://www.googleapis.com/auth/presentations

`replace(blobSource, crop)`

Ersetzt dieses Bild durch ein Bild, das durch ein Image-Objekt beschrieben wird. Optional wird das Bild zugeschnitten.

const image = SlidesApp.getActivePresentation().getSlides()[0].getImages()[0];
// Get the Drive image file with the given ID.
const driveImage = DriveApp.getFileById('123abc');
// Replace and crop the drive image.
image.replace(driveImage, true);

Parameter

Name	Typ	Beschreibung
`blobSource`	`BlobSource`	Die Bilddaten.
`crop`	`Boolean`	Bei `true` wird das Bild so zugeschnitten, dass es der Größe des vorhandenen Bildes entspricht. Andernfalls wird das Bild skaliert und zentriert.

Rückflug

Image – Diese Image nach dem Austausch.

Autorisierung

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

https://www.googleapis.com/auth/presentations.currentonly
https://www.googleapis.com/auth/presentations

`replace(imageUrl)`

Ersetzt dieses Bild durch ein anderes Bild, das von der angegebenen URL heruntergeladen wird.

Wenn Sie das Bild einfügen, wird es einmal von der URL abgerufen und eine Kopie wird zur Anzeige in der Präsentation gespeichert. Bilder dürfen nicht größer als 50 MB und nicht mehr als 25 Megapixel haben. Sie müssen im PNG-, JPEG- oder GIF-Format vorliegen.

Die angegebene URL muss öffentlich zugänglich und nicht größer als 2 KB sein. Die URL selbst wird mit dem Bild gespeichert und über getSourceUrl() freigegeben.

Um das Seitenverhältnis des Bildes beizubehalten, wird es skaliert und anhand der Größe des vorhandenen Bildes zentriert.

Parameter

Name	Typ	Beschreibung
`imageUrl`	`String`	Die URL, von der das Bild heruntergeladen werden soll.

Rückflug

Image – Diese Image nach dem Austausch.

Autorisierung

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

https://www.googleapis.com/auth/presentations.currentonly
https://www.googleapis.com/auth/presentations

`replace(imageUrl, crop)`

Ersetzt dieses Bild durch ein anderes Bild, das von der angegebenen URL heruntergeladen wird. Optional kann das Bild zugeschnitten werden.

Die angegebene URL darf maximal 2 KB groß sein.

Parameter

Name	Typ	Beschreibung
`imageUrl`	`String`	Die URL, von der das Bild heruntergeladen werden soll.
`crop`	`Boolean`	Bei `true` wird das Bild so zugeschnitten, dass es der Größe des vorhandenen Bildes entspricht. Andernfalls wird das Bild skaliert und zentriert.

Rückflug

Image – Diese Image nach dem Austausch.

Autorisierung

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

https://www.googleapis.com/auth/presentations.currentonly
https://www.googleapis.com/auth/presentations

`scaleHeight(ratio)`

Die Höhe des Elements wird mit dem angegebenen Verhältnis skaliert. Die Höhe des Elements entspricht der Höhe seines Begrenzungsrahmens, wenn das Element nicht gedreht ist.

Parameter

Name	Typ	Beschreibung
`ratio`	`Number`	Das Verhältnis, um das die Höhe dieses Seitenelements skaliert werden soll.

Rückflug

Image – dieses Seitenelement zur Verkettung

Autorisierung

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

https://www.googleapis.com/auth/presentations.currentonly
https://www.googleapis.com/auth/presentations

`scaleWidth(ratio)`

Die Breite des Elements wird mit dem angegebenen Verhältnis skaliert. Die Breite des Elements entspricht der Breite des Begrenzungsrahmens, wenn das Element nicht gedreht ist.

Parameter

Name	Typ	Beschreibung
`ratio`	`Number`	Das Verhältnis, um das die Breite dieses Seitenelements skaliert werden soll.

Rückflug

Image – dieses Seitenelement zur Verkettung

Autorisierung

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

https://www.googleapis.com/auth/presentations.currentonly
https://www.googleapis.com/auth/presentations

`select()`

Wählt nur die PageElement in der aktiven Präsentation aus und entfernt alle vorherigen Auswahlen. Das entspricht dem Aufruf von select(replace) mit true.

Ein Script kann nur auf die Auswahl des Nutzers zugreifen, der das Script ausführt, und nur dann, wenn das Script an die Präsentation gebunden ist.

Dadurch wird das übergeordnete Element Page der PageElement als current page selection festgelegt.

const slide = SlidesApp.getActivePresentation().getSlides()[0];
const pageElement = slide.getPageElements()[0];
// Only select this page element and replace any previous selection.
pageElement.select();

Autorisierung

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

https://www.googleapis.com/auth/presentations.currentonly
https://www.googleapis.com/auth/presentations

`select(replace)`

Wählt das PageElement in der aktiven Präsentation aus.

Ein Script kann nur auf die Auswahl des Nutzers zugreifen, der das Script ausführt, und nur dann, wenn das Script an die Präsentation gebunden ist.

Wenn Sie true an diese Methode übergeben, wird nur PageElement ausgewählt und alle vorherigen Auswahlen werden entfernt. Dadurch wird auch die übergeordnete Page der PageElement als current page selection festgelegt.

Geben Sie false ein, um mehrere PageElement-Objekte auszuwählen. Die PageElement-Objekte müssen sich im selben Page befinden.

Bei der Auswahl eines Seitenelements mit einem false-Parameter müssen die folgenden Bedingungen erfüllt sein:

Das übergeordnete Page-Element des PageElement-Objekts muss current page selection sein.
Es sollten nicht mehrere Page-Objekte ausgewählt sein.

Um dies sicherzustellen, sollten Sie zuerst das übergeordnete Element Page mit Page.selectAsCurrentPage() auswählen und dann die Seitenelemente auf dieser Seite.

const slide = SlidesApp.getActivePresentation().getSlides()[0];
// First select the slide page, as the current page selection.
slide.selectAsCurrentPage();
// Then select all the page elements in the selected slide page.
const pageElements = slide.getPageElements();
for (let i = 0; i < pageElements.length; i++) {
  pageElements[i].select(false);
}

Parameter

Name	Typ	Beschreibung
`replace`	`Boolean`	Wenn `true`, ersetzt die Auswahl eine vorherige Auswahl. Andernfalls wird die Auswahl einer vorherigen Auswahl hinzugefügt.

Autorisierung

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

https://www.googleapis.com/auth/presentations.currentonly
https://www.googleapis.com/auth/presentations

`sendBackward()`

Versetzt das Seitenelement auf der Seite um ein Element zurück.

Das Seitenelement darf sich nicht in einer Gruppe befinden.

Rückflug

Image – dieses Seitenelement zur Verkettung

Autorisierung

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

https://www.googleapis.com/auth/presentations.currentonly
https://www.googleapis.com/auth/presentations

`sendToBack()`

Versetzt das Seitenelement ans Ende der Seite.

Das Seitenelement darf sich nicht in einer Gruppe befinden.

Rückflug

Image – dieses Seitenelement zur Verkettung

Autorisierung

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

https://www.googleapis.com/auth/presentations.currentonly
https://www.googleapis.com/auth/presentations

`setDescription(description)`

Hiermit wird die Alt-Text-Beschreibung des Seitenelements festgelegt.

Die Methode wird für Group-Elemente nicht unterstützt.

// Set the first page element's alt text description to "new alt text
// description".
const pageElement =
    SlidesApp.getActivePresentation().getSlides()[0].getPageElements()[0];
pageElement.setDescription('new alt text description');
Logger.log(pageElement.getDescription());

Parameter

Name	Typ	Beschreibung
`description`	`String`	Der String, der als Alt-Text festgelegt werden soll.

Rückflug

Image – dieses Seitenelement.

Autorisierung

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

https://www.googleapis.com/auth/presentations.currentonly
https://www.googleapis.com/auth/presentations

`setHeight(height)`

Hiermit wird die Höhe des Elements in Punkten festgelegt. Das ist die Höhe des Begrenzungsrahmens des Elements, wenn es nicht gedreht ist.

Parameter

Name	Typ	Beschreibung
`height`	`Number`	Die neue Höhe dieses Seitenelements in Punkten.

Rückflug

Image – dieses Seitenelement zur Verkettung

Autorisierung

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

https://www.googleapis.com/auth/presentations.currentonly
https://www.googleapis.com/auth/presentations

`setLeft(left)`

Legt die horizontale Position des Elements in Punkten fest, gemessen von der linken oberen Ecke der Seite, wenn das Element nicht gedreht ist.

Parameter

Name	Typ	Beschreibung
`left`	`Number`	Die neue horizontale Position in Punkten.

Rückflug

Image – dieses Seitenelement zur Verkettung

Autorisierung

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

https://www.googleapis.com/auth/presentations.currentonly
https://www.googleapis.com/auth/presentations

`setLinkSlide(slideIndex)`

Legt mit dem nullbasierten Index der Folie eine Link für die angegebene Slide fest.

// Set a link to the first slide of the presentation.
const slides = SlidesApp.getActivePresentation().getSlides();
const shape = slides[1].getShapes()[0];
const link = shape.setLinkSlide(0);

Parameter

Name	Typ	Beschreibung
`slideIndex`	`Integer`	Der nullbasierte Index der Folie.

Rückflug

Link: Die festgelegte Link.

Autorisierung

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

https://www.googleapis.com/auth/presentations.currentonly
https://www.googleapis.com/auth/presentations

`setLinkSlide(slide)`

Hier wird eine Link auf die angegebene Slide festgelegt. Der Link wird anhand der angegebenen Folien-ID festgelegt.

// Set a link to the first slide of the presentation.
const slides = SlidesApp.getActivePresentation().getSlides();
const shape = slides[1].getShapes()[0];
const link = shape.setLinkSlide(slides[0]);

Parameter

Name	Typ	Beschreibung
`slide`	`Slide`	Die zu verknüpfende `Slide`.

Rückflug

Link: Die festgelegte Link.

Autorisierung

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

https://www.googleapis.com/auth/presentations.currentonly
https://www.googleapis.com/auth/presentations

`setLinkSlide(slidePosition)`

Legt mithilfe der relativen Position der Folie einen Link für die angegebene Slide fest.

// Set a link to the first slide of the presentation.
const slides = SlidesApp.getActivePresentation().getSlides();
const shape = slides[1].getShapes()[0];
const link = shape.setLinkSlide(SlidesApp.SlidePosition.FIRST_SLIDE);

Parameter

Name	Typ	Beschreibung
`slidePosition`	`SlidePosition`	Das relative `SlidePosition`.

Rückflug

Link: Die festgelegte Link.

Autorisierung

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

https://www.googleapis.com/auth/presentations.currentonly
https://www.googleapis.com/auth/presentations

`setLinkUrl(url)`

Legt einen Link für den angegebenen nicht leeren URL-String fest.

// Set a link to the URL.
const slides = SlidesApp.getActivePresentation().getSlides();
const shape = slides[1].getShapes()[0];
const link = shape.setLinkUrl('https://slides.google.com');

Parameter

Name	Typ	Beschreibung
`url`	`String`	Der URL-String.

Rückflug

Link: Die festgelegte Link.

Autorisierung

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

https://www.googleapis.com/auth/presentations.currentonly
https://www.googleapis.com/auth/presentations

`setRotation(angle)`

Legt den Drehwinkel des Elements im Uhrzeigersinn um seine Mitte in Grad fest.

Parameter

Name	Typ	Beschreibung
`angle`	`Number`	Der neue Drehwinkel im Uhrzeigersinn in Grad.

Rückflug

Image – dieses Seitenelement zur Verkettung

Autorisierung

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

https://www.googleapis.com/auth/presentations.currentonly
https://www.googleapis.com/auth/presentations

`setTitle(title)`

Hiermit wird der Titel des Alt-Texts für das Seitenelement festgelegt.

Die Methode wird für Group-Elemente nicht unterstützt.

// Set the first page element's alt text title to "new alt text title".
const pageElement =
    SlidesApp.getActivePresentation().getSlides()[0].getPageElements()[0];
pageElement.setTitle('new alt text title');
Logger.log(pageElement.getTitle());

Parameter

Name	Typ	Beschreibung
`title`	`String`	Der String, auf den der Titel des Alt-Texts festgelegt werden soll.

Rückflug

Image – dieses Seitenelement.

Autorisierung

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

https://www.googleapis.com/auth/presentations.currentonly
https://www.googleapis.com/auth/presentations

`setTop(top)`

Legt die vertikale Position des Elements in Punkten fest, gemessen von der linken oberen Ecke der Seite, wenn das Element nicht gedreht ist.

Parameter

Name	Typ	Beschreibung
`top`	`Number`	Die neue vertikale Position in Punkten.

Rückflug

Image – dieses Seitenelement zur Verkettung

Autorisierung

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

https://www.googleapis.com/auth/presentations.currentonly
https://www.googleapis.com/auth/presentations

`setTransform(transform)`

Legt die Transformation des Seitenelements mit der angegebenen Transformation fest.

Wenn Sie die Transformation einer Gruppe aktualisieren, ändert sich die absolute Transformation der Seitenelemente in dieser Gruppe, was sich auf ihr visuelles Erscheinungsbild auswirken kann.

Wenn Sie die Transformation eines Seitenelements in einer Gruppe aktualisieren, ändert sich nur die Transformation dieses Seitenelements. Die Transformationen der Gruppe oder anderer Seitenelemente in der Gruppe bleiben unverändert.

Weitere Informationen dazu, wie sich Transformationen auf das Erscheinungsbild von Seitenelementen auswirken, finden Sie unter getTransform().

Parameter

Name	Typ	Beschreibung
`transform`	`AffineTransform`	Die Transformation, die für dieses Seitenelement festgelegt ist.

Rückflug

Image – Dieses Element 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/presentations.currentonly
https://www.googleapis.com/auth/presentations

`setWidth(width)`

Hiermit wird die Breite des Elements in Punkten festgelegt. Das ist die Breite des Begrenzungsrahmens des Elements, wenn es nicht gedreht ist.

Parameter

Name	Typ	Beschreibung
`width`	`Number`	Die neue Breite dieses Seitenelements in Punkten.

Rückflug

Image – dieses Seitenelement zur Verkettung

Autorisierung

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

https://www.googleapis.com/auth/presentations.currentonly
https://www.googleapis.com/auth/presentations