Ein PageElement
, der ein Bild darstellt.
Methoden
Methode | Rückgabetyp | Kurzbeschreibung |
---|---|---|
alignOnPage(alignmentPosition) | Image | Richtet das Element an der angegebenen Ausrichtungsposition 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 das Border des Bilds zurück. |
getConnectionSites() | ConnectionSite[] | Gibt die Liste der ConnectionSite s im Seitenelement zurück. Wenn das Seitenelement keine Verbindungswebsites hat, wird eine leere Liste zurückgegeben. |
getContentUrl() | String | Ruft eine URL zum Bild ab. |
getDescription() | String | Gibt die alternative Textbeschreibung des Seitenelements zurück |
getHeight() | Number | Ruft die Höhe des Elements in Punkten ab, d. h. die Höhe des Begrenzungsrahmens des Elements, wenn das Element nicht gedreht wird. |
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, wenn das Element nicht gedreht wurde. |
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 sich das Element nicht in einer Gruppe befindet. |
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 Bildes oder PlaceholderType.NONE zurück, wenn die Form kein Platzhalter ist. |
getRotation() | Number | Gibt den Drehwinkel 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, falls 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 nicht gedreht wird. |
getTransform() | AffineTransform | Gibt die Transformation des Seitenelements zurück. |
getWidth() | Number | Gibt die Breite des Elements in Punkten zurück. Dies 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. |
remove() | void | Entfernt das Seitenelement. |
removeLink() | void | Entfernt Link . |
replace(blobSource) | Image | Ersetzt dieses Bild durch ein durch ein BlobSource -Objekt beschriebenes Bild. |
replace(blobSource, crop) | Image | Ersetzt dieses Bild durch ein durch ein Image -Objekt beschriebenes Bild. Es 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, das von der angegebenen URL heruntergeladen wurde. Das Bild wird optional zugeschnitten. |
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 PageElement in der aktiven Präsentation aus und entfernt alle vorherigen Auswahlen. |
select(replace) | void | Wählt PageElement in der aktiven Präsentation aus. |
sendBackward() | Image | Versetzt das Seitenelement auf der Seite um ein Element nach hinten. |
sendToBack() | Image | Versendet das Seitenelement an das Ende 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, wenn das Element nicht gedreht wird. |
setLinkSlide(slideIndex) | Link | Legt mithilfe des nullbasierten Index der Folie einen Link auf den angegebenen Slide fest. |
setLinkSlide(slide) | Link | Legt ein Link für die angegebene Slide fest. Die Verknüpfung wird durch die angegebene Folien-ID festgelegt. |
setLinkSlide(slidePosition) | Link | Legt einen Link auf den angegebenen Slide anhand der relativen Position der Folie fest. |
setLinkUrl(url) | Link | Legt einen Link auf den angegebenen nicht leeren URL-String fest. |
setRotation(angle) | Image | Legt den Drehwinkel des Elements im Uhrzeigersinn um seinen Mittelpunkt in Grad fest. |
setTitle(title) | Image | Legt den Alt-Texttitel des Seitenelements fest |
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 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 Ausrichtungsposition 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 für die Verkettung.
bringForward()
Bringt das Seitenelement auf der Seite um ein Element nach vorn.
Das Seitenelement darf nicht in einer Gruppe sein.
Return
Image
: Dieses Seitenelement für die 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 in einer Gruppe sein.
Return
Image
: Dieses Seitenelement für die 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. "myfile.pdf". Dabei wird jedoch davon ausgegangen, dass der Teil des Dateinamens, der auf den letzten Punkt (falls vorhanden) folgt, eine vorhandene Erweiterung ist, die ersetzt werden sollte. Aus „ShoppingList.12.25.2014“ wird dann „ShoppingList.12.25.pdf“.
Informationen zu den Tageskontingenten für Conversions finden Sie unter Kontingente für Google-Dienste. Für neu erstellte Google Workspace-Domains gelten möglicherweise vorübergehend strengere Kontingente.
Parameter
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. 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()
getBorder()
Gibt das Border
des Bilds zurück.
Return
Border
: Der Rahmen des Bilds.
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 ConnectionSite
s im Seitenelement zurück. Wenn das Seitenelement keine Verbindungswebsites hat, wird eine leere Liste zurückgegeben.
Return
ConnectionSite[]
: Die Liste der Verbindungswebsites. Diese kann leer sein, 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 mit der URL effektiv auf das Bild als ursprünglicher Anforderer zugreift. 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 alternative Textbeschreibung des Seitenelements zurück Die Beschreibung wird mit dem Titel kombiniert, um Alt-Text anzuzeigen und zu lesen.
Return
String
: Die alternative 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, d. h. die Höhe des Begrenzungsrahmens des Elements, wenn das Element nicht gedreht wird.
Diese Methode ist nicht mit allen Seitenelementen kompatibel. Informationen dazu, welche Seitenelemente mit dieser Methode nicht kompatibel sind, finden Sie unter Größen- und Positionierungsbeschränkungen.
Return
Number
: Die ursprüngliche 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 richtet sich nach seiner inhärenten Größe. Verwenden Sie die inhärente Größe in Verbindung mit der Transformation des Elements, um das endgültige visuelle Erscheinungsbild des Elements zu bestimmen.
Return
Number
: Die ursprüngliche 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.
Die Transformation des Seitenelements richtet sich nach seiner inhärenten Größe. Verwenden Sie die inhärente Größe in Verbindung mit der Transformation des Elements, um das endgültige visuelle Erscheinungsbild des Elements zu bestimmen.
Return
Number
: Die 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, wenn das Element nicht gedreht wurde.
Return
Number
: Die horizontale Position dieses Elements in Punkten, ausgehend von der linken oberen Ecke der Seite.
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
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 Objekt-IDs, die von Seiten und Seitenelementen verwendet werden, 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 sich das Element nicht in einer Gruppe befindet.
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 dieses Seitenelement befindet
Return
Page
: Die Seite, auf der sich das 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 Bild hat.
Return
PageElement
: Das übergeordnete Seitenelement dieses Bildplatzhalters oder null
, wenn das Bild kein Platzhalter ist oder kein übergeordnetes Bild 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 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
getRotation()
Gibt den Drehwinkel 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 (ausschließ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, falls verfügbar.
Wenn ein Bild per 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 alternative 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 nicht gedreht wird.
Return
Number
: Die vertikale Position dieses Elements in Punkten, ausgehend von der linken oberen Ecke der Seite.
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. Um die absolute Transformation zu berechnen, verketten Sie die Transformation eines Seitenelements mit den Transformationen aller übergeordneten Gruppen. Wenn das Seitenelement nicht in einer Gruppe ist, 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. Dies ist die Breite des Begrenzungsrahmens des Elements, wenn das Element nicht gedreht wird.
Diese Methode ist nicht mit allen Seitenelementen kompatibel. Informationen dazu, welche Seitenelemente mit dieser Methode nicht kompatibel sind, finden Sie unter Größen- und Positionierungsbeschränkungen.
Return
Number
: Die 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.
newTransform = argument * existingTransform
So verschieben Sie beispielsweise Seitenelemente um 36 Punkte nach links:
element.preconcatenateTransform(SlidesApp.newAffineTransformBuilder() .setTranslateX(-36.0) .build());
Sie können auch die Transformation des Seitenelements durch setTransform(transform)
ersetzen.
Parameter
Name | Typ | Beschreibung |
---|---|---|
transform | AffineTransform | Die Transformation, die mit der Transformation dieses Seitenelements verkettet werden soll. |
Return
Image
: Dieses Seitenelement für die 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 remove-Vorgang 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 Link
.
shape.removeLink();
replace(blobSource)
Ersetzt dieses Bild durch ein durch ein BlobSource
-Objekt beschriebenes Bild.
Wenn Sie das Bild einfügen, wird es einmal aus dem
BlobSource
abgerufen und eine Kopie wird gespeichert, um sie in der Präsentation anzuzeigen.
Bilder müssen kleiner als 50 MB sein und dürfen 25 Megapixel nicht überschreiten. Außerdem müssen sie im PNG-, JPEG- oder GIF-Format vorliegen.
Das Bild wird in Bezug auf die Größe des vorhandenen Bildes skaliert und zentriert, um das Seitenverhältnis des Bildes beizubehalten.
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
: Image
nach der Ersetzung.
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 durch ein Image
-Objekt beschriebenes Bild. Es wird optional zugeschnitten.
Wenn Sie das Bild einfügen, wird es einmal aus dem
BlobSource
abgerufen und eine Kopie wird gespeichert, um sie in der Präsentation anzuzeigen.
Bilder müssen kleiner als 50 MB sein und dürfen 25 Megapixel nicht überschreiten. Außerdem müssen sie im PNG-, JPEG- oder GIF-Format vorliegen.
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 true wird das Bild auf die Größe des vorhandenen Bildes zugeschnitten. Andernfalls wird das Bild skaliert und zentriert. |
Return
Image
: Image
nach der Ersetzung.
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 zur Anzeige in der Präsentation gespeichert. Bilder müssen kleiner als 50 MB sein und dürfen 25 Megapixel nicht überschreiten. 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()
bereitgestellt.
Das Bild wird in Bezug auf die Größe des vorhandenen Bildes skaliert und zentriert, um das Seitenverhältnis des Bildes beizubehalten.
Parameter
Name | Typ | Beschreibung |
---|---|---|
imageUrl | String | Die URL, von der das Bild heruntergeladen werden soll. |
Return
Image
: Image
nach der Ersetzung.
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, das von der angegebenen URL heruntergeladen wurde. Das Bild wird optional zugeschnitten.
Wenn Sie das Bild einfügen, wird es einmal aus der URL abgerufen und eine Kopie wird zur Anzeige in der Präsentation gespeichert. Bilder müssen kleiner als 50 MB sein und dürfen 25 Megapixel nicht überschreiten. Außerdem müssen sie im PNG-, JPEG- oder GIF-Format vorliegen.
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 true wird das Bild auf die Größe des vorhandenen Bildes zugeschnitten. Andernfalls wird das Bild skaliert und zentriert. |
Return
Image
: Image
nach der Ersetzung.
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. Die Höhe des Elements ist die Höhe seines Begrenzungsrahmens, wenn das Element nicht gedreht wird.
Diese Methode ist nicht mit allen Seitenelementen kompatibel. Informationen dazu, welche Seitenelemente mit dieser Methode nicht kompatibel sind, finden Sie unter Größen- und Positionierungsbeschränkungen.
Parameter
Name | Typ | Beschreibung |
---|---|---|
ratio | Number | Das Verhältnis, um das die Höhe dieses Seitenelements skaliert werden soll. |
Return
Image
: Dieses Seitenelement für die 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. Die Breite des Elements ist die Breite seines Begrenzungsrahmens, wenn das Element nicht gedreht wird.
Diese Methode ist nicht mit allen Seitenelementen kompatibel. Informationen dazu, welche Seitenelemente mit dieser Methode nicht kompatibel sind, finden Sie unter Größen- und Positionierungsbeschränkungen.
Parameter
Name | Typ | Beschreibung |
---|---|---|
ratio | Number | Das Verhältnis, um das die Breite dieses Seitenelements skaliert werden soll. |
Return
Image
: Dieses Seitenelement für die 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 PageElement
in der aktiven Präsentation aus und entfernt alle vorherigen Auswahlen. Dies entspricht dem Aufruf 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 es 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 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 es an die Präsentation gebunden ist.
Übergeben Sie true
an diese Methode, um nur PageElement
auszuwählen und die vorherige Auswahl 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.
Die folgenden Bedingungen müssen bei der Auswahl eines Seitenelements mit einem false
-Parameter erfüllt sein:
- Der übergeordnete
Page
desPageElement
-Objekts musscurrent page selection
sein. - Es dürfen nicht mehrere
Page
-Objekte ausgewählt sein.
Wir empfehlen, zuerst das übergeordnete Element Page
mithilfe von Page.selectAsCurrentPage()
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 jede vorherige Auswahl. Andernfalls wird die Auswahl zur 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 in einer Gruppe sein.
Return
Image
: Dieses Seitenelement für die 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()
Versendet das Seitenelement an das Ende der Seite.
Das Seitenelement darf nicht in einer Gruppe sein.
Return
Image
: Dieses Seitenelement für die 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 Beschreibung des alternativen Texts gesetzt 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. Informationen dazu, welche Seitenelemente mit dieser Methode nicht kompatibel sind, finden Sie unter Größen- und Positionierungsbeschränkungen.
Parameter
Name | Typ | Beschreibung |
---|---|---|
height | Number | Die neu festzulegende Höhe dieses Seitenelements in Punkten. |
Return
Image
: Dieses Seitenelement für die 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, wenn das Element nicht gedreht wird.
Parameter
Name | Typ | Beschreibung |
---|---|---|
left | Number | Die neu festzulegende horizontale Position in Punkten. |
Return
Image
: Dieses Seitenelement für die 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 mithilfe des nullbasierten Index der Folie einen Link
auf den angegebenen Slide
fest.
// Set a link to the first slide of the presentation. shape.setLinkSlide(0);
Parameter
Name | Typ | Beschreibung |
---|---|---|
slideIndex | Integer | Der nullbasierte Index für die Folie. |
Return
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
für die angegebene Slide
fest. Die Verknüpfung 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
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 einen Link
auf den angegebenen Slide
anhand der relativen Position der Folie fest.
// 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
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
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 Drehwinkel des Elements im Uhrzeigersinn um seinen Mittelpunkt in Grad fest.
Diese Methode ist nicht mit allen Seitenelementen kompatibel. Informationen dazu, welche Seitenelemente mit dieser Methode nicht kompatibel sind, finden Sie unter Größen- und Positionierungsbeschränkungen.
Parameter
Name | Typ | Beschreibung |
---|---|---|
angle | Number | Der neu festzulegende Drehwinkel im Uhrzeigersinn in Grad. |
Return
Image
: Dieses Seitenelement für die 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 Alt-Texttitel 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 | Zeichenfolge, auf die der Titel des Alt-Texts gesetzt 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, wenn das Element nicht gedreht wird.
Parameter
Name | Typ | Beschreibung |
---|---|---|
top | Number | Die neu festzulegende vertikale Position in Punkten. |
Return
Image
: Dieses Seitenelement für die 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. Dadurch kann sich ihr visuelles Erscheinungsbild ändern.
Wenn Sie die Transformation eines Seitenelements ändern, das sich in einer Gruppe befindet, ändert sich nur die Transformation dieses Seitenelements. Sie wirkt sich nicht auf die Transformationen der Gruppe oder anderer Seitenelemente in der Gruppe aus.
Weitere Informationen dazu, wie sich Transformationen auf die visuelle Darstellung von Seitenelementen auswirken, findest du unter getTransform()
.
Parameter
Name | Typ | Beschreibung |
---|---|---|
transform | AffineTransform | Die Transformation, die für dieses Seitenelement festgelegt ist. |
Return
Image
: Dieses Element für Verkettungen.
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. Informationen dazu, welche Seitenelemente mit dieser Methode nicht kompatibel sind, finden Sie unter Größen- und Positionierungsbeschränkungen.
Parameter
Name | Typ | Beschreibung |
---|---|---|
width | Number | Die neue Breite dieses Seitenelements, die in Punkten festgelegt werden soll. |
Return
Image
: Dieses Seitenelement für die 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