Diese Seite wurde von der Cloud Translation API übersetzt.

Class Shape

Ein PageElement, das eine generische Form darstellt, die keine spezifischere Form hat Klassifizierung. Dazu gehören Textfelder, Rechtecke und andere vordefinierte Formen.

Methoden

Methode	Rückgabetyp	Kurzbeschreibung
`alignOnPage(alignmentPosition)`	`Shape`	Richtet das Element an der angegebenen Position auf der Seite aus.
`bringForward()`	`Shape`	Bringt das Seitenelement auf der Seite um ein Element nach vorn
`bringToFront()`	`Shape`	Bringt das Seitenelement in den Vordergrund der Seite
`duplicate()`	`PageElement`	Dupliziert das Seitenelement.
`getAutofit()`	`Autofit`	Gibt die `Autofit` des Textes in dieser Form zurück
`getBorder()`	`Border`	Gibt den `Border` der Form 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.
`getContentAlignment()`	`ContentAlignment`	Gibt das `ContentAlignment` des Textes in der Form zurück.
`getDescription()`	`String`	Gibt die Alt-Textbeschreibung des Seitenelements zurück
`getFill()`	`Fill`	Gibt den `Fill` der Form 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 Platzhalterindex der Form zurück.
`getPlaceholderType()`	`PlaceholderType`	Gibt den Platzhaltertyp der Form 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.
`getShapeType()`	`ShapeType`	Gibt den Typ der Form zurück.
`getText()`	`TextRange`	Gibt den Textinhalt der Form zurück.
`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. Das Element weist keine Rotation auf.
`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)`	`Shape`	Verkettet die angegebene Transformation mit der vorhandenen Transformation des Seitenelements vor.
`remove()`	`void`	Entfernt das Seitenelement.
`removeLink()`	`void`	Entfernt einen `Link`.
`replaceWithImage(blobSource)`	`Image`	Ersetzt diese Form durch ein von `BlobSource` bereitgestelltes Bild.
`replaceWithImage(blobSource, crop)`	`Image`	Ersetzt diese Form durch ein von `BlobSource` bereitgestelltes Bild.
`replaceWithImage(imageUrl)`	`Image`	Ersetzt diese Form durch ein Bild.
`replaceWithImage(imageUrl, crop)`	`Image`	Ersetzt diese Form durch ein Bild.
`replaceWithSheetsChart(sourceChart)`	`SheetsChart`	Ersetzt diese Form durch ein Google Tabellen-Diagramm.
`replaceWithSheetsChartAsImage(sourceChart)`	`Image`	Ersetzt diese Form durch ein Bild eines Google Tabellen-Diagramms.
`scaleHeight(ratio)`	`Shape`	Skaliert die Höhe des Elements um das angegebene Verhältnis.
`scaleWidth(ratio)`	`Shape`	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()`	`Shape`	Versetzt das Seitenelement auf der Seite um ein Element nach hinten
`sendToBack()`	`Shape`	Versetzt das Seitenelement an den hinteren Teil der Seite
`setContentAlignment(contentAlignment)`	`Shape`	Legt den `ContentAlignment` des Textes in der Form fest.
`setDescription(description)`	`Shape`	Legt die Alt-Textbeschreibung des Seitenelements fest.
`setHeight(height)`	`Shape`	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)`	`Shape`	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)`	`Shape`	Legt den Rotationswinkel des Elements im Uhrzeigersinn um seinen Mittelpunkt in Grad fest.
`setTitle(title)`	`Shape`	Legt den Titel des Alt-Textes des Seitenelements fest.
`setTop(top)`	`Shape`	Legt die vertikale Position des Elements in Punkten fest, gemessen von der linken oberen Ecke der Seite aus Das Element weist keine Rotation auf.
`setTransform(transform)`	`Shape`	Legt die Transformation des Seitenelements mit der angegebenen Transformation fest.
`setWidth(width)`	`Shape`	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

Shape: 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

Shape: 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

Shape: 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

`getAutofit()`

Gibt die Autofit des Textes in dieser Form zurück Dies ist null, wenn die Form lässt keinen Text zu.

Rückflug

Autofit: Die automatische Anpassung des Textes innerhalb der Form.

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

`getBorder()`

Gibt den Border der Form zurück.

Rückflug

Border: Die Rahmeneinstellung dieser Form.

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 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

`getContentAlignment()`

Gibt das ContentAlignment des Textes in der Form zurück.

Rückflug

ContentAlignment: Die Ausrichtung des Textes innerhalb dieser Form.

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

`getFill()`

Gibt den Fill der Form zurück.

Rückflug

Fill: Die Fülleinstellung für die Form.

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.

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

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 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 die Form kein Platzhalter oder hat kein übergeordnetes Element.

Rückflug

PageElement: Das übergeordnete Seitenelement dieses Formplatzhalters oder null, wenn diese Form 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 Platzhalterindex der Form zurück. Wenn zwei oder mehr Instanzen desselben Platzhalters Typen auf derselben Seite vorhanden sind und jeder einen eigenen eindeutigen Indexwert hat. Gibt null zurück, wenn die Form kein Platzhalter ist.

Rückflug

Integer: Platzhalterindex dieser Form oder null, wenn die Form 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 der Form oder PlaceholderType.NONE zurück, wenn die Form nicht Platzhalter.

Rückflug

PlaceholderType: Der Platzhaltertyp dieser Form.

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

`getShapeType()`

Gibt den Typ der Form zurück.

Rückflug

ShapeType: Der Typ dieser Form.

`getText()`

Gibt den Textinhalt der Form zurück.

Text innerhalb einer Form endet immer mit einem Zeilenumbruchzeichen.

Rückflug

TextRange: Der Textinhalt dieser Form.

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

Shape: 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();

`replaceWithImage(blobSource)`

Ersetzt diese Form durch ein von BlobSource bereitgestelltes Bild.

Das Bild wird einmal zum Einfügen von der bereitgestellten BlobSource abgerufen und als Kopie für die Anzeige in der Präsentation gespeichert. Bilder müssen kleiner als 50 MB sein. größer als 25 Megapixel und muss im PNG-, JPEG- oder GIF-Format vorliegen.

Um das Seitenverhältnis des Bildes beizubehalten, wird das Bild entsprechend skaliert und zentriert. an die Größe der vorhandenen Form angepasst.

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

Parameter

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

Rückflug

Image: Der Image-Wert, durch den die Form ersetzt wurde.

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

`replaceWithImage(blobSource, crop)`

Ersetzt diese Form durch ein von BlobSource bereitgestelltes Bild.

Wenn Sie das Bild einfügen, wird es einmal aus dem BlobSource abgerufen und eine Kopie wird für in der Präsentation angezeigt werden sollen. Bilder müssen kleiner als 50 MB und nicht größer als 25 sein Megapixel und muss im PNG-, JPEG- oder GIF-Format vorliegen.

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

Parameter

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

Rückflug

Image: Der Image-Wert, durch den die Form ersetzt wurde.

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

`replaceWithImage(imageUrl)`

Ersetzt diese Form durch ein Bild.

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 Image.getSourceUrl().

Um das Seitenverhältnis des Bildes beizubehalten, wird das Bild entsprechend skaliert und zentriert. an die Größe der vorhandenen Form angepasst.

Parameter

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

Rückflug

Image: Der Image-Wert, durch den die Form ersetzt wurde.

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

`replaceWithImage(imageUrl, crop)`

Ersetzt diese Form durch ein Bild.

Die angegebene URL darf nicht größer als 2 KB sein. Die URL selbst wird mit dem Bild und exponiert über Image.getSourceUrl().

Parameter

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

Rückflug

Image: Der Image-Wert, durch den die Form ersetzt wurde.

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

`replaceWithSheetsChart(sourceChart)`

Ersetzt diese Form durch ein Google Tabellen-Diagramm.

Das Diagramm ist mit dem Google Tabellen-Quelldiagramm verknüpft und kann daher aktualisiert werden. Sonstiges können Mitbearbeiter den Link zur Quelltabelle sehen.

var sheet = SpreadsheetApp.openById('spreadsheetId').getSheets()[0];
var chart = sheet.getCharts()[0];
// Replace the shape with the Sheets chart.
var shape = SlidesApp.getActivePresentation().getSlides()[0].getShapes()[0];
shape.replaceWithSheetsChart(chart);

Parameter

Name	Typ	Beschreibung
`sourceChart`	`EmbeddedChart`	Das Diagramm in einer Tabellenkalkulation, das die Form ersetzt

Rückflug

SheetsChart: Das Diagramm, das die Form ersetzt 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

`replaceWithSheetsChartAsImage(sourceChart)`

Ersetzt diese Form durch ein Bild eines Google Tabellen-Diagramms.

Damit das Seitenverhältnis des Google Tabellen-Diagramms erhalten bleibt, wird das Bild skaliert und im Verhältnis zur Größe der vorhandenen Form zentriert.

Das Bild des Diagramms ist nicht mit dem Google Tabellen-Quelldiagramm verknüpft.

var sheet = SpreadsheetApp.openById('spreadsheetId').getSheets()[0];
var chart = sheet.getCharts()[0];
// Replace the shape with the Sheets chart as an image.
var shape = SlidesApp.getActivePresentation().getSlides()[0].getShapes()[0];
shape.replaceWithSheetsChartAsImage(chart);

Parameter

Name	Typ	Beschreibung
`sourceChart`	`EmbeddedChart`	Das Diagramm in einer Tabellenkalkulation, das die Form ersetzt

Rückflug

Image: Das Bild des Diagramms, das die Form ersetzt 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

`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

Shape: 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

Shape: 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 des PageElement-Objekts muss die current 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

Shape: 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

Shape: 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

`setContentAlignment(contentAlignment)`

Legt den ContentAlignment des Textes in der Form fest.

Mit dieser Methode werden die Eigenschaften der automatischen Textanpassung für die aktualisierten Formen automatisch deaktiviert.

Parameter

Name	Typ	Beschreibung
`contentAlignment`	`ContentAlignment`	Die festzulegende Ausrichtung.

Rückflug

Shape: Diese Form zum Verketten.

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

Shape: 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

Shape: 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

Shape: 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

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`.

Rückflug

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`.

Rückflug

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.

Rückflug

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. 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

Shape: 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

Shape: 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

Shape: 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

Shape: 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

Shape: 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