Class Shape

Form

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

Methoden

MethodeRückgabetypKurzbeschreibung
alignOnPage(alignmentPosition)ShapeDas Element wird an der angegebenen Ausrichtungsposition auf der Seite ausgerichtet.
bringForward()ShapeVerschiebt das Seitenelement auf der Seite um ein Element nach vorne.
bringToFront()ShapeDas Seitenelement wird an den Anfang der Seite verschoben.
duplicate()PageElementDas Seitenelement wird dupliziert.
getAutofit()AutofitGibt die Autofit des Texts innerhalb dieser Form zurück.
getBorder()BorderGibt die Border der Form zurück.
getConnectionSites()ConnectionSite[]Gibt die Liste der ConnectionSites im Seitenelement zurück oder eine leere Liste, wenn das Seitenelement keine Verbindungsstellen hat.
getContentAlignment()ContentAlignmentGibt den ContentAlignment des Texts in der Form zurück.
getDescription()StringGibt die Alt-Text-Beschreibung des Seitenelements zurück.
getFill()FillGibt die Fill der Form zurück.
getHeight()NumberDie Höhe des Elements in Punkten. Das ist die Höhe des Begrenzungsrahmens des Elements, wenn es nicht gedreht ist.
getInherentHeight()NumberGibt die Höhe des Elements in Punkten zurück.
getInherentWidth()NumberGibt die Breite des Elements in Punkten zurück.
getLeft()NumberGibt die horizontale Position des Elements in Punkten zurück, gemessen von der linken oberen Ecke der Seite, wenn das Element nicht gedreht ist.
getLink()LinkGibt Link oder null zurück, wenn kein Link vorhanden ist.
getObjectId()StringDie eindeutige ID für dieses Objekt.
getPageElementType()PageElementTypeGibt den Typ des Seitenelements als PageElementType-Enum zurück.
getParentGroup()GroupGibt die Gruppe zurück, zu der dieses Seitenelement gehört, oder null, wenn das Element keiner Gruppe zugewiesen ist.
getParentPage()PageGibt die Seite zurück, auf der sich dieses Seitenelement befindet.
getParentPlaceholder()PageElementGibt das übergeordnete Seitenelement des Platzhalters zurück.
getPlaceholderIndex()IntegerGibt den Platzhalterindex der Form zurück.
getPlaceholderType()PlaceholderTypeGibt den Platzhaltertyp der Form zurück oder PlaceholderType.NONE, wenn die Form kein Platzhalter ist.
getRotation()NumberGibt den Drehwinkel des Elements im Uhrzeigersinn um seine Mitte in Grad zurück. Null Grad bedeutet, dass das Element nicht gedreht wird.
getShapeType()ShapeTypeGibt den Typ der Form zurück.
getText()TextRangeGibt den Textinhalt der Form zurück.
getTitle()StringGibt den Titel des Alt-Texts des Seitenelements zurück.
getTop()NumberDie vertikale Position des Elements in Punkten, gemessen von der oberen linken Ecke der Seite, wenn das Element nicht gedreht ist.
getTransform()AffineTransformGibt die Transformation des Seitenelements zurück.
getWidth()NumberGibt die Breite des Elements in Punkten zurück. Das ist die Breite des Begrenzungsrahmens des Elements, wenn es nicht gedreht ist.
preconcatenateTransform(transform)ShapeDie angegebene Transformation wird mit der vorhandenen Transformation des Seitenelements vorkonkateniert.
remove()voidEntfernt das Seitenelement.
removeLink()voidEntfernt einen Link.
replaceWithImage(blobSource)ImageErsetzt diese Form durch ein Bild, das von einem BlobSource bereitgestellt wird.
replaceWithImage(blobSource, crop)ImageErsetzt diese Form durch ein Bild, das von einem BlobSource bereitgestellt wird.
replaceWithImage(imageUrl)ImageErsetzt diese Form durch ein Bild.
replaceWithImage(imageUrl, crop)ImageErsetzt diese Form durch ein Bild.
replaceWithSheetsChart(sourceChart)SheetsChartErsetzt diese Form durch ein Google Tabellen-Diagramm.
replaceWithSheetsChartAsImage(sourceChart)ImageDiese Form wird durch ein Bild eines Google Tabellen-Diagramms ersetzt.
scaleHeight(ratio)ShapeDie Höhe des Elements wird mit dem angegebenen Verhältnis skaliert.
scaleWidth(ratio)ShapeDie Breite des Elements wird mit dem angegebenen Verhältnis skaliert.
select()voidWählt nur die PageElement in der aktiven Präsentation aus und entfernt alle vorherigen Auswahlen.
select(replace)voidWählt das PageElement in der aktiven Präsentation aus.
sendBackward()ShapeVersetzt das Seitenelement auf der Seite um ein Element zurück.
sendToBack()ShapeVersetzt das Seitenelement ans Ende der Seite.
setContentAlignment(contentAlignment)ShapeLegt die ContentAlignment des Texts in der Form fest.
setDescription(description)ShapeHiermit wird die Alt-Text-Beschreibung des Seitenelements festgelegt.
setHeight(height)ShapeHiermit wird die Höhe des Elements in Punkten festgelegt. Das ist die Höhe des Begrenzungsrahmens des Elements, wenn es nicht gedreht ist.
setLeft(left)ShapeLegt die horizontale Position des Elements in Punkten fest, gemessen von der linken oberen Ecke der Seite, wenn das Element nicht gedreht ist.
setLinkSlide(slideIndex)LinkLegt mit dem nullbasierten Index der Folie eine Link für die angegebene Slide fest.
setLinkSlide(slide)LinkHier wird eine Link auf die angegebene Slide festgelegt. Der Link wird anhand der angegebenen Folien-ID festgelegt.
setLinkSlide(slidePosition)LinkLegt mithilfe der relativen Position der Folie einen Link für die angegebene Slide fest.
setLinkUrl(url)LinkLegt einen Link für den angegebenen nicht leeren URL-String fest.
setRotation(angle)ShapeLegt den Drehwinkel des Elements im Uhrzeigersinn um seine Mitte in Grad fest.
setTitle(title)ShapeHiermit wird der Titel des Alt-Texts für das Seitenelement festgelegt.
setTop(top)ShapeLegt die vertikale Position des Elements in Punkten fest, gemessen von der linken oberen Ecke der Seite, wenn das Element nicht gedreht ist.
setTransform(transform)ShapeLegt die Transformation des Seitenelements mit der angegebenen Transformation fest.
setWidth(width)ShapeHiermit wird die Breite des Elements in Punkten festgelegt. Das ist die Breite des Begrenzungsrahmens des Elements, wenn es nicht gedreht ist.

Detaillierte Dokumentation

alignOnPage(alignmentPosition)

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

Parameter

NameTypBeschreibung
alignmentPositionAlignmentPositionDie Position, an der dieses Seitenelement auf der Seite ausgerichtet werden soll.

Rückflug

Shape – dieses Seitenelement zur Verkettung

bringForward()

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

Das Seitenelement darf sich nicht in einer Gruppe befinden.

Rückflug

Shape – dieses Seitenelement zur Verkettung

Autorisierung

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

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

bringToFront()

Das Seitenelement wird an den Anfang der Seite verschoben.

Das Seitenelement darf sich nicht in einer Gruppe befinden.

Rückflug

Shape – dieses Seitenelement zur Verkettung

Autorisierung

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

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

duplicate()

Das Seitenelement wird dupliziert.

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

Rückflug

PageElement: Das neue Duplikat dieses Seitenelements.

Autorisierung

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

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

getAutofit()

Gibt die Autofit des Texts innerhalb dieser Form zurück. Das ist null, wenn für die Form kein Text zulässig ist.

Rückflug

Autofit: Die automatische Anpassung des Texts in dieser Form.

Autorisierung

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

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

getBorder()

Gibt die Border der Form zurück.

Rückflug

Border: Die Rahmeneinstellung dieser Form.

Autorisierung

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

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

getConnectionSites()

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

Rückflug

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

Autorisierung

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

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

getContentAlignment()

Gibt den ContentAlignment des Texts in der Form zurück.

Rückflug

ContentAlignment: Ausrichtung des Texts in dieser Form.

Autorisierung

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

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

getDescription()

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

Rückflug

String: Die Alt-Text-Beschreibung des Seitenelements.

Autorisierung

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

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

getFill()

Gibt die Fill der Form zurück.

Rückflug

Fill: Die Füllungseinstellung dieser Form.

Autorisierung

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

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

getHeight()

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

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

Rückflug

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

Autorisierung

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

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

getInherentHeight()

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

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

Rückflug

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

Autorisierung

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

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

getInherentWidth()

Gibt die Breite des Elements in Punkten zurück.

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

Rückflug

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

Autorisierung

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

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

getLeft()

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

Rückflug

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

Autorisierung

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

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

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

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

Rückflug

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

Autorisierung

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

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

getObjectId()

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

Rückflug

String: Die eindeutige ID für dieses Objekt.

Autorisierung

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

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

getPageElementType()

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

Rückflug

PageElementType: Der Typ des Seitenelements.

Autorisierung

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

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

getParentGroup()

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

Rückflug

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

Autorisierung

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

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

getParentPage()

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

Rückflug

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

Autorisierung

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

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

getParentPlaceholder()

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

Rückflug

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

Autorisierung

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

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

getPlaceholderIndex()

Gibt den Platzhalterindex der Form zurück. Wenn sich auf derselben Seite zwei oder mehr Instanzen desselben Platzhaltertyps befinden, haben sie jeweils einen eigenen Indexwert. Gibt null zurück, wenn die Form kein Platzhalter ist.

Rückflug

Integer: Platzhalterindex dieser Form oder null, wenn es sich nicht um einen Platzhalter handelt.

Autorisierung

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

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

getPlaceholderType()

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

Rückflug

PlaceholderType: Der Platzhaltertyp dieser Form.

Autorisierung

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

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

getRotation()

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

Rückflug

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

Autorisierung

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

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

getShapeType()

Gibt den Typ der Form zurück.

Rückflug

ShapeType: Der Typ dieser Form.

getText()

Gibt den Textinhalt der Form zurück.

Text in einer Form endet immer mit einem Zeilenumbruchzeichen.

Rückflug

TextRange: Der Textinhalt dieser Form.

Autorisierung

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

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

getTitle()

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

Rückflug

String: Der Titel des Alt-Texts des Seitenelements.

Autorisierung

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

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

getTop()

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

Rückflug

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

Autorisierung

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

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

getTransform()

Gibt die Transformation des Seitenelements zurück.

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

Rückflug

AffineTransform: Die Transformation des Seitenelements.

Autorisierung

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

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

getWidth()

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

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

Rückflug

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

Autorisierung

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

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

preconcatenateTransform(transform)

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

newTransform = argument * existingTransform;

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

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

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

Parameter

NameTypBeschreibung
transformAffineTransformDie Transformation, die vor der Transformation dieses Seitenelements vorkonkateniert werden soll.

Rückflug

Shape – dieses Seitenelement zur Verkettung

Autorisierung

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

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

remove()

Entfernt das Seitenelement.

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

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

Autorisierung

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

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

Entfernt einen Link. 

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

replaceWithImage(blobSource)

Ersetzt diese Form durch ein Bild, das von einem BlobSource bereitgestellt wird.

Das Bild wird beim Einfügen einmal von der angegebenen BlobSource abgerufen und eine Kopie wird zur Anzeige in der Präsentation gespeichert. Bilder dürfen nicht größer als 50 MB und 25 Megapixel sein und müssen im PNG-, JPEG- oder GIF-Format vorliegen.

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

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

Parameter

NameTypBeschreibung
blobSourceBlobSourceDie Bilddaten.

Rückflug

Image: Der Image, der die Form ersetzt hat.

Autorisierung

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

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

replaceWithImage(blobSource, crop)

Ersetzt diese Form durch ein Bild, das von einem BlobSource bereitgestellt wird.

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

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

Parameter

NameTypBeschreibung
blobSourceBlobSourceDie Bilddaten.
cropBooleanBei true wird das Bild so zugeschnitten, dass es in die Größe der vorhandenen Form passt. Andernfalls wird das Bild skaliert und zentriert.

Rückflug

Image: Der Image, der die Form ersetzt hat.

Autorisierung

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

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

replaceWithImage(imageUrl)

Ersetzt diese Form durch ein Bild.

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

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

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

Parameter

NameTypBeschreibung
imageUrlStringDie Bild-URL, von der das Bild heruntergeladen werden soll.

Rückflug

Image: Der Image, der die Form ersetzt hat.

Autorisierung

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

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

replaceWithImage(imageUrl, crop)

Ersetzt diese Form durch ein Bild.

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

Die angegebene URL darf maximal 2 KB groß sein. Die URL selbst wird mit dem Bild gespeichert und über Image.getSourceUrl() freigegeben.

Parameter

NameTypBeschreibung
imageUrlStringDie Bild-URL, von der das Bild heruntergeladen werden soll.
cropBooleanBei true wird das Bild so zugeschnitten, dass es in die Größe der vorhandenen Form passt. Andernfalls wird das Bild skaliert und zentriert.

Rückflug

Image: Der Image, der die Form ersetzt hat.

Autorisierung

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

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

replaceWithSheetsChart(sourceChart)

Ersetzt diese Form durch ein Google Tabellen-Diagramm.

Das Diagramm ist mit dem Google Tabellen-Quelldiagramm verknüpft, sodass es aktualisiert werden kann. Andere Mitbearbeiter sehen den Link zur Quelltabelle. 

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

Parameter

NameTypBeschreibung
sourceChartEmbeddedChartDas Diagramm in einer Tabelle, das die Form ersetzt.

Rückflug

SheetsChart: Das Diagramm, das die Form ersetzt hat.

Autorisierung

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

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

replaceWithSheetsChartAsImage(sourceChart)

Diese Form wird durch ein Bild eines Google Tabellen-Diagramms ersetzt.

Damit das Seitenverhältnis des Google Tabellen-Diagramms beibehalten wird, wird das Diagrammbild skaliert und anhand der Größe der vorhandenen Form zentriert.

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

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

Parameter

NameTypBeschreibung
sourceChartEmbeddedChartDas Diagramm in einer Tabelle, das die Form ersetzt.

Rückflug

Image: Das Bild des Diagramms, das die Form ersetzt hat.

Autorisierung

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

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

scaleHeight(ratio)

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

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

Parameter

NameTypBeschreibung
ratioNumberDas Verhältnis, um das die Höhe dieses Seitenelements skaliert werden soll.

Rückflug

Shape – dieses Seitenelement zur Verkettung

Autorisierung

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

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

scaleWidth(ratio)

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

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

Parameter

NameTypBeschreibung
ratioNumberDas Verhältnis, um das die Breite dieses Seitenelements skaliert werden soll.

Rückflug

Shape – dieses Seitenelement zur Verkettung

Autorisierung

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

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

select()

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

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

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

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

Autorisierung

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

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

select(replace)

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

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

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

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

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

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

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

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

Parameter

NameTypBeschreibung
replaceBooleanWenn true, ersetzt die Auswahl eine vorherige Auswahl. Andernfalls wird die Auswahl einer vorherigen Auswahl hinzugefügt.

Autorisierung

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

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

sendBackward()

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

Das Seitenelement darf sich nicht in einer Gruppe befinden.

Rückflug

Shape – dieses Seitenelement zur Verkettung

Autorisierung

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

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

sendToBack()

Versetzt das Seitenelement ans Ende der Seite.

Das Seitenelement darf sich nicht in einer Gruppe befinden.

Rückflug

Shape – dieses Seitenelement zur Verkettung

Autorisierung

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

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

setContentAlignment(contentAlignment)

Legt die ContentAlignment des Texts in der Form fest.

Bei dieser Methode werden die Eigenschaften für die automatische Textanpassung für die aktualisierten Formen automatisch deaktiviert.

Parameter

NameTypBeschreibung
contentAlignmentContentAlignmentDie Ausrichtung, die festgelegt werden soll.

Rückflug

Shape – Diese Form für die Verkettung.

Autorisierung

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

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

setDescription(description)

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

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

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

Parameter

NameTypBeschreibung
descriptionStringDer String, der als Alt-Text festgelegt werden soll.

Rückflug

Shape – dieses Seitenelement.

Autorisierung

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

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

setHeight(height)

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

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

Parameter

NameTypBeschreibung
heightNumberDie neue Höhe dieses Seitenelements in Punkten.

Rückflug

Shape – dieses Seitenelement zur Verkettung

Autorisierung

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

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

setLeft(left)

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

Parameter

NameTypBeschreibung
leftNumberDie neue horizontale Position in Punkten.

Rückflug

Shape – dieses Seitenelement zur Verkettung

Autorisierung

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

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

setLinkSlide(slideIndex)

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

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

Parameter

NameTypBeschreibung
slideIndexIntegerDer nullbasierte Index der Folie.

Rückflug

Link: Die festgelegte Link.

Autorisierung

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

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

setLinkSlide(slide)

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

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

Parameter

NameTypBeschreibung
slideSlideDie zu verknüpfende Slide.

Rückflug

Link: Die festgelegte Link.

Autorisierung

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

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

setLinkSlide(slidePosition)

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

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

Parameter

NameTypBeschreibung
slidePositionSlidePositionDas relative SlidePosition.

Rückflug

Link: Die festgelegte Link.

Autorisierung

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

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

setLinkUrl(url)

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

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

Parameter

NameTypBeschreibung
urlStringDer URL-String.

Rückflug

Link: Die festgelegte Link.

Autorisierung

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

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

setRotation(angle)

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

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

Parameter

NameTypBeschreibung
angleNumberDer neue Drehwinkel im Uhrzeigersinn in Grad.

Rückflug

Shape – dieses Seitenelement zur Verkettung

Autorisierung

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

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

setTitle(title)

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

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

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

Parameter

NameTypBeschreibung
titleStringDer String, auf den der Titel des Alt-Texts festgelegt werden soll.

Rückflug

Shape – dieses Seitenelement.

Autorisierung

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

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

setTop(top)

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

Parameter

NameTypBeschreibung
topNumberDie neue vertikale Position in Punkten.

Rückflug

Shape – dieses Seitenelement zur Verkettung

Autorisierung

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

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

setTransform(transform)

Legt die Transformation des Seitenelements mit der angegebenen Transformation fest.

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

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

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

Parameter

NameTypBeschreibung
transformAffineTransformDie Transformation, die für dieses Seitenelement festgelegt ist.

Rückflug

Shape – Dieses Element für die Verkettung.

Autorisierung

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

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

setWidth(width)

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

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

Parameter

NameTypBeschreibung
widthNumberDie neue Breite dieses Seitenelements in Punkten.

Rückflug

Shape – dieses Seitenelement zur Verkettung

Autorisierung

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

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