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 die Seite
-Element verfügt über keine Verbindungs-Websites. |
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, d. h. die Höhe des Begrenzungsrahmens des Elements, wenn der keine Drehung aufweist. |
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 oberen linken Ecke des wenn das Element nicht gedreht ist. |
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 einem
Gruppe. |
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 nicht
Platzhalter. |
getRotation() | Number | Gibt den Rotationswinkel des Elements im Uhrzeigersinn um seinen Mittelpunkt in Grad zurück, wobei null Grad beträgt. bedeutet keine Drehung. |
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 keine Drehung aufweist. |
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 Markierungsrahmens des Elements, wenn Das Element weist keine Rotation auf. |
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 durch ein Image -Objekt beschrieben wird, und kann optional zugeschnitten werden
das Bild passt. |
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 wird optional zugeschnitten. das Bild passt. |
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 alle vorherigen
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, d. h. die Höhe des Begrenzungsrahmens des Elements, wenn das keine Drehung aufweist. |
setLeft(left) | Image | Legt die horizontale Position des Elements in Punkten fest, gemessen von der oberen linken Ecke des wenn das Element nicht gedreht ist. |
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 keine Drehung aufweist. |
setTransform(transform) | Image | Legt die Transformation des Seitenelements mit der angegebenen Transformation fest. |
setWidth(width) | Image | Legt die Breite des Elements in Punkten fest, d. h. die Breite des Begrenzungsrahmens des Elements, wenn das keine Drehung aufweist. |
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. |
Rückflug
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.
Rückflug
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.
Rückflug
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.
Rückflug
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. Dieses fügt dem Dateinamen die entsprechende Erweiterung hinzu, beispielsweise "meinedatei.pdf". Allerdings geht davon aus, dass der Teil des Dateinamens, der auf den letzten Punkt folgt (falls vorhanden), ein vorhandener die ersetzt werden soll. Daher lautet „Einkaufsliste.12.25.2014“. wird zu „Einkaufsliste.12.25.pdf“.
Die Tageskontingente für Conversions finden Sie unter Kontingente für Google Dienste. Neu erstellte Google Workspace-Domains unterliegen möglicherweise vorübergehend strengeren Richtlinien. Kontingenten.
Parameter
Name | Typ | Beschreibung |
---|---|---|
contentType | String | Der MIME-Typ, in den konvertiert werden soll. Für die meisten Blobs ist 'application/pdf'
ist die einzige gültige Option. Für Bilder im BMP-, GIF-, JPEG- oder PNG-Format gilt auch Folgendes: 'image/bmp' , 'image/gif' , 'image/jpeg' oder 'image/png'
gültig sein. Bei einem Google Docs-Dokument ist 'text/markdown' ebenfalls gültig. |
Rückflug
Blob
: Die Daten als Blob.
getBlob()
getBorder()
Gibt die Border
des Bilds zurück.
Rückflug
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 ConnectionSite
s für das Seitenelement oder eine leere Liste zurück, wenn die Seite
-Element verfügt über keine Verbindungs-Websites.
Rückflug
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 Antragstellers getaggt, sodass jeder, der über die URL verfügt, greift als ursprünglicher Anforderer auf das Bild zu. Der Zugriff auf das Bild kann verloren gehen, wenn das die Freigabeeinstellungen der Präsentation ändern. Die zurückgegebene URL läuft nach kurzer Zeit ab.
Rückflug
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, Alternativtext anzeigen und vorlesen lassen.
Rückflug
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, d. h. die Höhe des Begrenzungsrahmens des Elements, wenn der keine Drehung aufweist.
Diese Methode ist nicht mit allen Seitenelementen kompatibel. Um herauszufinden, welche Seitenelemente kompatibel mit dieser Methode finden Sie im Größen- und Positionierungsbeschränkungen.
Rückflug
Number
: die Höhe des Seitenelements in Punkten oder null
, wenn das
keine Höhe haben.
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 in mit der Transformation des Elements kombiniert, um das endgültige visuelle Erscheinungsbild des Elements festzulegen.
Rückflug
Number
: die Höhe des Seitenelements in Punkten oder null
, wenn das
keine Höhe haben.
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 ist relativ zu seiner inhärenten Größe. Verwenden Sie die inhärente Größe in mit der Transformation des Elements kombiniert, um das endgültige visuelle Erscheinungsbild des Elements festzulegen.
Rückflug
Number
: die inhärente Breite des Seitenelements in Punkten oder null
, wenn das
keine Breite haben.
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 oberen linken Ecke des wenn das Element nicht gedreht ist.
Rückflug
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()); }
Rückflug
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 Die von Seiten und Seitenelementen verwendeten Objekt-IDs haben den gleichen denselben Namespace.
Rückflug
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.
Rückflug
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 einem
Gruppe.
Rückflug
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
Rückflug
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 oder hat kein übergeordnetes Element.
Rückflug
PageElement
: Das übergeordnete Seitenelement dieses Bildplatzhalters oder null
, wenn dieses Bild nicht
Platzhalter enthält 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 vorhanden sind
sind vom gleichen Typ und haben jeweils einen eindeutigen Indexwert. Gibt null
zurück, wenn das Bild nicht
Platzhalter.
Rückflug
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 nicht
Platzhalter.
Rückflug
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 beträgt. bedeutet keine Drehung.
Rückflug
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, falls verfügbar.
Wenn ein Bild über eine URL eingefügt wird, wird die URL zurückgegeben, die beim Einfügen des Bildes angegeben wurde.
Rückflug
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, Alternativtext anzeigen und vorlesen lassen.
Rückflug
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. Das Element weist keine Rotation auf.
Rückflug
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. Bis Berechnung der absoluten Transformation, Verkettung der Transformation eines Seitenelements mit den Transformationen übergeordneten Gruppen angezeigt. Wenn sich das Seitenelement nicht in einer Gruppe befindet, ist seine absolute Transformation mit dem Wert in diesem Feld identisch.
Rückflug
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 Markierungsrahmens des Elements, wenn Das Element weist keine Rotation auf.
Diese Methode ist nicht mit allen Seitenelementen kompatibel. Um herauszufinden, welche Seitenelemente kompatibel mit dieser Methode finden Sie im Größen- und Positionierungsbeschränkungen.
Rückflug
Number
: die inhärente Breite des Seitenelements in Punkten oder null
, wenn das
keine Breite haben.
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. |
Rückflug
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,
Gruppe selbst wird ebenfalls entfernt.
Wenn der Platzhalter PageElement
aus einem Master oder Layout entfernt wird, werden leere Werte übernommen,
werden ebenfalls 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 aus dem
BlobSource
einmal. Anschließend wird eine Kopie gespeichert, die in der Präsentation angezeigt werden kann.
Bilder müssen kleiner als 50 MB und nicht mehr als 25 Megapixel sein. Außerdem müssen sie
PNG, JPEG oder GIF.
Um das Seitenverhältnis des Bildes beizubehalten, wird das Bild entsprechend skaliert und zentriert. an die Größe des vorhandenen Images an.
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. |
Rückflug
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 durch ein Image
-Objekt beschrieben wird, und kann optional zugeschnitten werden
das Bild passt.
Wenn Sie das Bild einfügen, wird es aus dem
BlobSource
einmal. Anschließend wird eine Kopie gespeichert, die in der Präsentation angezeigt werden kann.
Bilder müssen kleiner als 50 MB und nicht mehr als 25 Megapixel sein. Außerdem müssen sie
PNG, JPEG oder GIF.
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 Feld
wird das Bild skaliert und zentriert. |
Rückflug
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 im zu präsentieren. Bilder müssen kleiner als 50 MB, nicht größer als 25 Megapixel und im PNG-, JPEG- oder GIF-Format.
Die angegebene URL muss öffentlich zugänglich sein und darf nicht größer als 2 KB sein. Die URL selbst wird gespeichert.
mit dem Bild und belichtet über getSourceUrl()
.
Um das Seitenverhältnis des Bildes beizubehalten, wird das Bild entsprechend skaliert und zentriert. an die Größe des vorhandenen Images an.
Parameter
Name | Typ | Beschreibung |
---|---|---|
imageUrl | String | Die URL, von der das Bild heruntergeladen werden soll. |
Rückflug
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 wird optional zugeschnitten. das Bild passt.
Wenn Sie das Bild einfügen, wird es einmal aus der URL abgerufen und eine Kopie wird gespeichert, die im zu präsentieren. Bilder müssen kleiner als 50 MB, nicht größer als 25 Megapixel und im PNG-, JPEG- oder GIF-Format.
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 Feld
wird das Bild skaliert und zentriert. |
Rückflug
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. Die Höhe des Elements ist die Höhe seiner Begrenzungsrahmen, wenn das Element keine Rotation aufweist.
Diese Methode ist nicht mit allen Seitenelementen kompatibel. Um herauszufinden, welche Seitenelemente kompatibel mit dieser Methode finden Sie im Größen- und Positionierungsbeschränkungen.
Parameter
Name | Typ | Beschreibung |
---|---|---|
ratio | Number | Das Seitenverhältnis, um das die Höhe dieses Seitenelements skaliert werden soll. |
Rückflug
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. Die Breite des Elements ist die Breite seiner Begrenzungsrahmen, wenn das Element keine Rotation aufweist.
Diese Methode ist nicht mit allen Seitenelementen kompatibel. Um herauszufinden, welche Seitenelemente kompatibel mit dieser Methode finden Sie im Größen- und Positionierungsbeschränkungen.
Parameter
Name | Typ | Beschreibung |
---|---|---|
ratio | Number | Das Seitenverhältnis, um das die Breite dieses Seitenelements skaliert werden soll. |
Rückflug
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 alle vorherigen
Auswahl. Dies entspricht dem Aufrufen von select(replace)
mit true
.
Ein Script kann nur auf die Auswahl des Nutzers zugreifen, der das Script ausführt, Das Skript ist an die Präsentation gebunden.
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 Script kann nur auf die Auswahl des Nutzers zugreifen, der das Script ausführt, Das Skript ist an die Präsentation gebunden.
Übergeben Sie true
an diese Methode, um nur das PageElement
auszuwählen und alle zu entfernen
vorherige Auswahl. Dadurch wird auch das übergeordnete Element Page
von PageElement
als
current page selection
Übergeben Sie false
, um mehrere PageElement
-Objekte auszuwählen. Das PageElement
Objekte müssen sich im selben Page
befinden.
Die folgenden Bedingungen müssen erfüllt sein, wenn Sie ein Seitenelement mithilfe eines false
-Elements auswählen
Parameter:
- Die übergeordnete
Page
desPageElement
-Objekts muss diecurrent page selection
sein. - Es sollten nicht mehrere
Page
-Objekte ausgewählt sein.
Aus diesem Grund empfiehlt es sich, das übergeordnete Element Page
auszuwählen.
Verwenden Sie zuerst Page.selectAsCurrentPage()
und wählen Sie dann die Seitenelemente auf dieser Seite aus.
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
Auswahl wird 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 zu einer Gruppe gehören.
Rückflug
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.
Rückflug
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. |
Rückflug
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, d. h. die Höhe des Begrenzungsrahmens des Elements, wenn das keine Drehung aufweist.
Diese Methode ist nicht mit allen Seitenelementen kompatibel. Um herauszufinden, welche Seitenelemente kompatibel mit dieser Methode finden Sie im Größen- und Positionierungsbeschränkungen.
Parameter
Name | Typ | Beschreibung |
---|---|---|
height | Number | Die neue festzulegende Höhe dieses Seitenelements in Punkten. |
Rückflug
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 oberen linken Ecke des wenn das Element nicht gedreht ist.
Parameter
Name | Typ | Beschreibung |
---|---|---|
left | Number | Die neue festzulegende horizontale Position in Punkten. |
Rückflug
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. |
Rückflug
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 . |
Rückflug
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 . |
Rückflug
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. |
Rückflug
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. Um herauszufinden, welche Seitenelemente kompatibel mit dieser Methode finden Sie im Größen- und Positionierungsbeschränkungen.
Parameter
Name | Typ | Beschreibung |
---|---|---|
angle | Number | Der neue festzulegende Winkel für die Drehung im Uhrzeigersinn in Grad. |
Rückflug
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. |
Rückflug
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 Das Element weist keine Rotation auf.
Parameter
Name | Typ | Beschreibung |
---|---|---|
top | Number | Die neue festzulegende vertikale Position in Punkten. |
Rückflug
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.
Durch das Aktualisieren der Transformation einer Gruppe wird die absolute Transformation der Seitenelemente in und diese Gruppe, die ihr visuelles Erscheinungsbild ändern kann.
Durch die Aktualisierung der Transformation eines Seitenelements, das sich in einer Gruppe befindet, ändert sich nur die Transformation von dieses Seitenelements; wirkt sich dies nicht auf die Transformationen der Gruppe oder andere Seitenelemente in der Gruppe.
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. |
Rückflug
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, d. h. die Breite des Begrenzungsrahmens des Elements, wenn das keine Drehung aufweist.
Diese Methode ist nicht mit allen Seitenelementen kompatibel. Um herauszufinden, welche Seitenelemente kompatibel mit dieser Methode finden Sie im Größen- und Positionierungsbeschränkungen.
Parameter
Name | Typ | Beschreibung |
---|---|---|
width | Number | Die neue festzulegende Breite dieses Seitenelements in Punkten. |
Rückflug
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