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`	Richtet das Element an der angegebenen Position auf der Seite aus.
`bringForward()`	`Image`	Bringt das Seitenelement auf der Seite um ein Element nach vorn
`bringToFront()`	`Image`	Bringt das Seitenelement in den Vordergrund der Seite
`duplicate()`	`PageElement`	Dupliziert das Seitenelement.
`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 Bild als Blob zurück.
`getBorder()`	`Border`	Gibt die `Border` des Bilds zurück.
`getConnectionSites()`	`ConnectionSite[]`	Gibt die Liste der `ConnectionSite`s für das Seitenelement oder eine leere Liste zurück, wenn das Seitenelement keine Verbindungswebsites hat.
`getContentUrl()`	`String`	Ruft eine URL zum Bild ab.
`getDescription()`	`String`	Gibt die Alt-Textbeschreibung des Seitenelements zurück
`getHeight()`	`Number`	Ruft die Höhe des Elements in Punkten ab. Dies ist die Höhe des Begrenzungsrahmens des Elements, wenn das Element keine Rotation hat.
`getInherentHeight()`	`Number`	Gibt die inhärente Höhe des Elements in Punkten zurück
`getInherentWidth()`	`Number`	Gibt die inhärente 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 aus, wenn das Element keine Drehung aufweist.
`getLink()`	`Link`	Gibt das `Link` oder `null` zurück, wenn kein Link vorhanden ist.
`getObjectId()`	`String`	Gibt die eindeutige ID für dieses Objekt zurück
`getPageElementType()`	`PageElementType`	Gibt den Typ des Seitenelements zurück, dargestellt als `PageElementType`-Enum.
`getParentGroup()`	`Group`	Gibt die Gruppe zurück, zu der dieses Seitenelement gehört, oder `null`, wenn das Element nicht zu einer Gruppe gehört
`getParentPage()`	`Page`	Gibt die Seite zurück, auf der sich das 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 Bildes oder `PlaceholderType.NONE` zurück, wenn die Form kein Platzhalter ist.
`getRotation()`	`Number`	Gibt den Rotationswinkel des Elements im Uhrzeigersinn um seinen Mittelpunkt in Grad zurück, wobei null Grad keine Drehung bedeutet.
`getSourceUrl()`	`String`	Ruft die Quell-URL des Bildes ab, sofern verfügbar.
`getTitle()`	`String`	Gibt den Alt-Texttitel des Seitenelements zurück
`getTop()`	`Number`	Ruft die vertikale Position des Elements in Punkten ab, gemessen von der linken oberen Ecke der Seite, wenn das Element keine Drehung aufweist.
`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 das Element nicht gedreht wird.
`preconcatenateTransform(transform)`	`Image`	Verkettet die angegebene Transformation mit der vorhandenen Transformation des Seitenelements vor.
`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 von einem `Image`-Objekt beschrieben wird. Das Bild wird optional zugeschnitten.
`replace(imageUrl)`	`Image`	Ersetzt dieses Bild durch ein anderes Bild, das von der angegebenen URL heruntergeladen wurde.
`replace(imageUrl, crop)`	`Image`	Ersetzt dieses Bild durch ein anderes Bild, das von der angegebenen URL heruntergeladen wurde. Das Bild kann optional zugeschnitten werden.
`scaleHeight(ratio)`	`Image`	Skaliert die Höhe des Elements um das angegebene Verhältnis.
`scaleWidth(ratio)`	`Image`	Skaliert die Breite des Elements um das angegebene Verhältnis.
`select()`	`void`	Wählt nur das `PageElement` in der aktiven Präsentation aus und entfernt jede vorherige Auswahl.
`select(replace)`	`void`	Wählt das `PageElement` in der aktiven Präsentation aus.
`sendBackward()`	`Image`	Versetzt das Seitenelement auf der Seite um ein Element nach hinten.
`sendToBack()`	`Image`	Versetzt das Seitenelement an den hinteren Teil der Seite
`setDescription(description)`	`Image`	Legt die Alt-Textbeschreibung des Seitenelements fest.
`setHeight(height)`	`Image`	Legt die Höhe des Elements in Punkten fest. Das ist die Höhe des Begrenzungsrahmens des Elements, wenn das Element nicht gedreht wird.
`setLeft(left)`	`Image`	Legt die horizontale Position des Elements in Punkten fest, gemessen von der linken oberen Ecke der Seite aus, wenn das Element keine Drehung aufweist.
`setLinkSlide(slideIndex)`	`Link`	Legt ein `Link` auf das angegebene `Slide` fest, wobei der nullbasierte Index der Folie verwendet wird.
`setLinkSlide(slide)`	`Link`	Legt ein `Link` auf das angegebene `Slide` fest, der Link wird durch die angegebene Folien-ID festgelegt.
`setLinkSlide(slidePosition)`	`Link`	Legt ein `Link` auf das angegebene `Slide` fest, wobei die relative Position der Folie verwendet wird.
`setLinkUrl(url)`	`Link`	Legt einen `Link` auf den angegebenen nicht leeren URL-String fest.
`setRotation(angle)`	`Image`	Legt den Rotationswinkel des Elements im Uhrzeigersinn um seinen Mittelpunkt in Grad fest.
`setTitle(title)`	`Image`	Legt den Titel des Alt-Textes des Seitenelements fest.
`setTop(top)`	`Image`	Legt die vertikale Position des Elements in Punkten fest, gemessen von der linken oberen Ecke der Seite aus, wenn das Element nicht gedreht wird.
`setTransform(transform)`	`Image`	Legt die Transformation des Seitenelements mit der angegebenen Transformation fest.
`setWidth(width)`	`Image`	Legt die Breite des Elements in Punkten fest. Das ist die Breite des Begrenzungsrahmens des Elements, wenn das Element nicht gedreht wird.

Detaillierte Dokumentation

`alignOnPage(alignmentPosition)`

Richtet das Element an der angegebenen Position auf der Seite aus.

Parameter

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

Return

Image: Dieses Seitenelement zur Verkettung.

`bringForward()`

Bringt das Seitenelement auf der Seite um ein Element nach vorn

Das Seitenelement darf nicht zu einer Gruppe gehören.

Return

Image: Dieses Seitenelement zur Verkettung.

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

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

`bringToFront()`

Bringt das Seitenelement in den Vordergrund der Seite

Das Seitenelement darf nicht zu einer Gruppe gehören.

Return

Image: Dieses Seitenelement zur Verkettung.

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

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

`duplicate()`

Dupliziert das Seitenelement.

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

Return

PageElement: Das neue Duplikat dieses Seitenelements.

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren 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, das in den angegebenen Inhaltstyp konvertiert wurde. Bei dieser Methode wird dem Dateinamen die entsprechende Erweiterung hinzugefügt, z. B. „meinedatei.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 muss. Daher wird "Einkaufsliste.12.25.2014" zu "Einkaufsliste.12.25.pdf".

Die Tageskontingente 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. Bei den 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 Bild als Blob zurück.

Return

Blob: Die Bilddaten als Blob.

`getBorder()`

Gibt die Border des Bilds zurück.

Return

Border: Der Rahmen des Bildes.

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

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

`getConnectionSites()`

Gibt die Liste der ConnectionSites für das Seitenelement oder eine leere Liste zurück, wenn das Seitenelement keine Verbindungswebsites hat.

Return

ConnectionSite[]: Die Liste der Verbindungswebsites, die leer sein kann, wenn dieses Element keine Verbindungswebsites hat.

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren 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 Anforderers getaggt, sodass jeder, der über die URL verfügt, als ursprünglicher Anforderer auf das Bild zugreifen kann. 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.

Return

String

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

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

`getDescription()`

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

Return

String: Die Alt-Textbeschreibung des Seitenelements.

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

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

`getHeight()`

Ruft die Höhe des Elements in Punkten ab. Dies ist die Höhe des Begrenzungsrahmens des Elements, wenn das Element keine Rotation hat.

Diese Methode ist nicht mit allen Seitenelementen kompatibel. Welche Seitenelemente nicht mit dieser Methode kompatibel sind, erfahren Sie in den Einschränkungen für Größen und Positionierung.

Return

Number: die inhärente Höhe des Seitenelements in Punkten oder null, wenn das Seitenelement keine Höhe hat.

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

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

`getInherentHeight()`

Gibt die inhärente Höhe des Elements in Punkten zurück

Die Transformation des Seitenelements ist relativ zu seiner inhärenten Größe. Verwenden Sie die inhärente Größe zusammen mit der Transformation des Elements, um das endgültige visuelle Erscheinungsbild des Elements zu bestimmen.

Return

Number: die inhärente Höhe des Seitenelements in Punkten oder null, wenn das Seitenelement keine Höhe hat.

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

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

`getInherentWidth()`

Gibt die inhärente Breite des Elements in Punkten zurück.

Return

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

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren 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 aus, wenn das Element keine Drehung aufweist.

Return

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

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

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

`getLink()`

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

var link = shape.getLink();
if (link != null) {
  Logger.log('Shape has a link of type: ' + link.getLinkType());
}

Return

Link

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

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

`getObjectId()`

Gibt die eindeutige ID für dieses Objekt zurück Von Seiten und Seitenelementen verwendete Objekt-IDs haben denselben Namespace.

Return

String: Die eindeutige ID für dieses Objekt.

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

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

`getPageElementType()`

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

Return

PageElementType: Der Typ des Seitenelements.

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren 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 nicht zu einer Gruppe gehört

Return

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

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren 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 das Seitenelement befindet

Return

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

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren 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.

Return

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

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren 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 gleichen Typ sind, haben sie jeweils einen eindeutigen Indexwert. Gibt null zurück, wenn das Bild kein Platzhalter ist.

Return

Integer: Der Platzhalterindex dieses Bildes oder null, wenn das Bild kein Platzhalter ist.

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

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

`getPlaceholderType()`

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

Return

PlaceholderType: Der Platzhaltertyp dieses Bildes.

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

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

`getRotation()`

Gibt den Rotationswinkel des Elements im Uhrzeigersinn um seinen Mittelpunkt in Grad zurück, wobei null Grad keine Drehung bedeutet.

Return

Number: Der Rotationswinkel in Grad zwischen 0 (einschließlich) und 360 (einschließlich).

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

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

`getSourceUrl()`

Ruft die Quell-URL des Bildes ab, sofern verfügbar.

Wenn ein Bild über eine URL eingefügt wird, wird die URL zurückgegeben, die beim Einfügen des Bildes angegeben wurde.

Return

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

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

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

`getTitle()`

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

Return

String: Der Alt-Texttitel des Seitenelements.

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

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

`getTop()`

Ruft die vertikale Position des Elements in Punkten ab, gemessen von der linken oberen Ecke der Seite, wenn das Element keine Drehung aufweist.

Return

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

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

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

`getTransform()`

Gibt die Transformation des Seitenelements zurück.

Die visuelle Darstellung des Seitenelements wird durch seine absolute Transformation bestimmt. Zum Berechnen der absoluten Transformation verketten Sie die Transformation eines Seitenelements mit den Transformationen aller übergeordneten Gruppen vor. Wenn sich das Seitenelement nicht in einer Gruppe befindet, entspricht seine absolute Transformation dem Wert in diesem Feld.

Return

AffineTransform: Die Transformation des Seitenelements.

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren 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 das Element nicht gedreht wird.

Diese Methode ist nicht mit allen Seitenelementen kompatibel. Welche Seitenelemente nicht mit dieser Methode kompatibel sind, erfahren Sie in den Einschränkungen für Größen und Positionierung.

Return

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

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

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

`preconcatenateTransform(transform)`

Verkettet die angegebene Transformation mit der vorhandenen Transformation des Seitenelements vor.

newTransform = argument * existingTransform

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

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 auf die Transformation dieses Seitenelements vorbereitet werden soll.

Return

Image: Dieses Seitenelement zur Verkettung.

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

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

`remove()`

Entfernt das Seitenelement.

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

Wenn der Platzhalter PageElement aus einem Master oder Layout entfernt wird, werden auch alle leeren übernehmenden Platzhalter entfernt.

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

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

`removeLink()`

Entfernt einen Link.

shape.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 dem BlobSource abgerufen und eine Kopie wird gespeichert, die in der Präsentation angezeigt werden kann. Bilder müssen kleiner als 50 MB und nicht größer als 25 Megapixel sein. Außerdem müssen sie im PNG-, JPEG- oder GIF-Format vorliegen.

Damit das Seitenverhältnis des Bilds erhalten bleibt, wird das Bild im Verhältnis zur Größe des vorhandenen Bildes skaliert und zentriert.

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

Parameter

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

Return

Image: Dieser Image nach dem Austausch.

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren 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 von einem Image-Objekt beschrieben wird. Das Bild wird optional zugeschnitten.

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

Parameter

Name	Typ	Beschreibung
`blobSource`	`BlobSource`	Die Bilddaten.
`crop`	`Boolean`	Bei der Einstellung `true` wird das Bild auf die Größe des vorhandenen Bildes zugeschnitten. Andernfalls wird das Bild skaliert und zentriert.

Return

Image: Dieser Image nach dem Austausch.

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren 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 wurde.

Wenn Sie das Bild einfügen, wird es einmal aus der URL abgerufen und eine Kopie wird gespeichert, die in der Präsentation angezeigt wird. Bilder müssen kleiner als 50 MB und nicht größer als 25 Megapixel sein. Außerdem müssen sie im PNG-, JPEG- oder GIF-Format vorliegen.

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

Damit das Seitenverhältnis des Bilds erhalten bleibt, wird das Bild im Verhältnis zur Größe des vorhandenen Bildes skaliert und zentriert.

Parameter

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

Return

Image: Dieser Image nach dem Austausch.

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren 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 wurde. Das Bild kann optional zugeschnitten werden.

Die angegebene URL darf nicht größer als 2 KB sein.

Parameter

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

Return

Image: Dieser Image nach dem Austausch.

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

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

`scaleHeight(ratio)`

Skaliert die Höhe des Elements um das angegebene Verhältnis. Wenn das Element nicht gedreht wird, entspricht die Höhe des Elements der Höhe des Begrenzungsrahmens.

Diese Methode ist nicht mit allen Seitenelementen kompatibel. Welche Seitenelemente nicht mit dieser Methode kompatibel sind, erfahren Sie in den Einschränkungen für Größen und Positionierung.

Parameter

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

Return

Image: Dieses Seitenelement zur Verkettung.

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

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

`scaleWidth(ratio)`

Skaliert die Breite des Elements um das angegebene Verhältnis. Wenn das Element nicht gedreht wird, entspricht die Breite des Elements der Breite des Begrenzungsrahmens.

Diese Methode ist nicht mit allen Seitenelementen kompatibel. Welche Seitenelemente nicht mit dieser Methode kompatibel sind, erfahren Sie in den Einschränkungen für Größen und Positionierung.

Parameter

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

Return

Image: Dieses Seitenelement zur Verkettung.

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

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

`select()`

Wählt nur das PageElement in der aktiven Präsentation aus und entfernt jede vorherige Auswahl. Dies entspricht dem Aufrufen von select(replace) mit true.

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

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

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

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren 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 Skript kann nur auf die Auswahl des Nutzers zugreifen, der das Skript ausführt, und auch nur dann, wenn das Skript an die Präsentation gebunden ist.

Übergeben Sie true an diese Methode, um nur PageElement auszuwählen und alle vorherigen Auswahlen zu entfernen. Dadurch wird auch das übergeordnete Element Page von PageElement als current page selection festgelegt.

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

Beim Auswählen eines Seitenelements mithilfe eines false-Parameters müssen die folgenden Bedingungen erfüllt sein:

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

Um das zu erreichen, empfiehlt es sich, zuerst das übergeordnete Page-Element mit Page.selectAsCurrentPage() auszuwählen und dann die Seitenelemente auf dieser Seite auszuwählen.

var 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.
var pageElements = slide.getPageElements();
for (var i = 0; i < pageElements.length; i++) {
  pageElements[i].select(false);
}

Parameter

Name	Typ	Beschreibung
`replace`	`Boolean`	Bei `true` ersetzt die Auswahl die vorherige Auswahl. Andernfalls wird die Auswahl zu einer beliebigen vorherigen Auswahl hinzugefügt.

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren 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 nach hinten.

Das Seitenelement darf nicht zu einer Gruppe gehören.

Return

Image: Dieses Seitenelement zur Verkettung.

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

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

`sendToBack()`

Versetzt das Seitenelement an den hinteren Teil der Seite

Das Seitenelement darf nicht zu einer Gruppe gehören.

Return

Image: Dieses Seitenelement zur Verkettung.

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

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

`setDescription(description)`

Legt die Alt-Textbeschreibung des Seitenelements fest.

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

// Set the first page element's alt text description to "new alt text description".
var 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, auf den die alternative Textbeschreibung festgelegt werden soll.

Return

Image: Dieses Seitenelement.

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

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

`setHeight(height)`

Legt die Höhe des Elements in Punkten fest. Das ist die Höhe des Begrenzungsrahmens des Elements, wenn das Element nicht gedreht wird.

Diese Methode ist nicht mit allen Seitenelementen kompatibel. Welche Seitenelemente nicht mit dieser Methode kompatibel sind, erfahren Sie in den Einschränkungen für Größen und Positionierung.

Parameter

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

Return

Image: Dieses Seitenelement zur Verkettung.

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren 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 aus, wenn das Element keine Drehung aufweist.

Parameter

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

Return

Image: Dieses Seitenelement zur Verkettung.

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

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

`setLinkSlide(slideIndex)`

Legt ein Link auf das angegebene Slide fest, wobei der nullbasierte Index der Folie verwendet wird.

// Set a link to the first slide of the presentation.
shape.setLinkSlide(0);

Parameter

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

Return

Link – die festgelegte Link

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

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

`setLinkSlide(slide)`

Legt ein Link auf das angegebene Slide fest, der Link wird durch die angegebene Folien-ID festgelegt.

// Set a link to the first slide of the presentation.
var slide = presentation.getSlides()[0];
shape.setLinkSlide(slide);

Parameter

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

Return

Link – die festgelegte Link

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

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

`setLinkSlide(slidePosition)`

Legt ein Link auf das angegebene Slide fest, wobei die relative Position der Folie verwendet wird.

// Set a link to the first slide of the presentation.
shape.setLinkSlide(SlideApp.SlidePosition.FIRST_SLIDE);

Parameter

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

Return

Link – die festgelegte Link

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

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

`setLinkUrl(url)`

Legt einen Link auf den angegebenen nicht leeren URL-String fest.

// Set a link to the URL.
shape.setLinkUrl("https://slides.google.com");

Parameter

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

Return

Link – die festgelegte Link

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

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

`setRotation(angle)`

Legt den Rotationswinkel des Elements im Uhrzeigersinn um seinen Mittelpunkt in Grad fest.

Diese Methode ist nicht mit allen Seitenelementen kompatibel. Welche Seitenelemente nicht mit dieser Methode kompatibel sind, erfahren Sie in den Einschränkungen für Größen und Positionierung.

Parameter

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

Return

Image: Dieses Seitenelement zur Verkettung.

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

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

`setTitle(title)`

Legt den Titel des Alt-Textes des Seitenelements fest.

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

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

Parameter

Name	Typ	Beschreibung
`title`	`String`	Die Zeichenfolge, auf die der Titel des alternativen Textes festgelegt werden soll.

Return

Image: Dieses Seitenelement.

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren 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 aus, wenn das Element nicht gedreht wird.

Parameter

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

Return

Image: Dieses Seitenelement zur Verkettung.

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren 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 auch die absolute Transformation der Seitenelemente in dieser Gruppe, wodurch sich auch ihre visuelle Darstellung ändert.

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 sind davon nicht betroffen.

Weitere Informationen dazu, wie sich Transformationen auf die visuelle Darstellung von Seitenelementen auswirken, finden Sie unter getTransform().

Parameter

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

Return

Image: Dieses Element zur Verkettung.

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

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

`setWidth(width)`

Legt die Breite des Elements in Punkten fest. Das ist die Breite des Begrenzungsrahmens des Elements, wenn das Element nicht gedreht wird.

Diese Methode ist nicht mit allen Seitenelementen kompatibel. Welche Seitenelemente nicht mit dieser Methode kompatibel sind, erfahren Sie in den Einschränkungen für Größen und Positionierung.

Parameter

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

Return

Image: Dieses Seitenelement zur Verkettung.

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

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