Class Shape

Form

Ein PageElement, der eine allgemeine Form ohne spezifischere Klassifizierung darstellt. Enthält Textfelder, Rechtecke und andere vordefinierte Formen.

Methoden

MethodeRückgabetypKurzbeschreibung
alignOnPage(alignmentPosition)ShapeRichtet das Element an der angegebenen Ausrichtungsposition auf der Seite aus.
bringForward()ShapeBringt das Seitenelement auf der Seite um ein Element nach vorn.
bringToFront()ShapeBringt das Seitenelement in den Vordergrund der Seite.
duplicate()PageElementDupliziert das Seitenelement.
getAutofit()AutofitGibt den Autofit des Texts innerhalb dieser Form zurück.
getBorder()BorderGibt das Border der Form zurück.
getConnectionSites()ConnectionSite[]Gibt die Liste der ConnectionSites im Seitenelement zurück. Wenn das Seitenelement keine Verbindungswebsites hat, wird eine leere Liste zurückgegeben.
getContentAlignment()ContentAlignmentGibt den ContentAlignment des Texts in der Form zurück
getDescription()StringGibt die alternative Textbeschreibung des Seitenelements zurück
getFill()FillGibt das Fill der Form zurück.
getHeight()NumberRuft die Höhe des Elements in Punkten ab, d. h. die Höhe des Begrenzungsrahmens des Elements, wenn das Element nicht gedreht wird.
getInherentHeight()NumberGibt die inhärente Höhe des Elements in Punkten zurück.
getInherentWidth()NumberGibt die inhärente 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 wurde.
getLink()LinkGibt das Link oder null zurück, wenn kein Link vorhanden ist.
getObjectId()StringGibt die eindeutige ID für dieses Objekt zurück
getPageElementType()PageElementTypeGibt den Typ des Seitenelements zurück, dargestellt als PageElementType-Enum.
getParentGroup()GroupGibt die Gruppe zurück, zu der dieses Seitenelement gehört, oder null, wenn sich das Element nicht in einer Gruppe befindet.
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 oder PlaceholderType.NONE zurück, wenn die Form kein Platzhalter ist.
getRotation()NumberGibt den Drehwinkel des Elements im Uhrzeigersinn um seinen Mittelpunkt in Grad zurück, wobei null Grad keine Drehung bedeutet.
getShapeType()ShapeTypeGibt den Typ der Form zurück
getText()TextRangeGibt den Textinhalt der Form zurück
getTitle()StringGibt den Alt-Texttitel des Seitenelements zurück
getTop()NumberRuft die vertikale Position des Elements in Punkten ab, gemessen von der linken oberen Ecke der Seite, wenn das Element nicht gedreht wird.
getTransform()AffineTransformGibt die Transformation des Seitenelements zurück.
getWidth()NumberGibt die Breite des Elements in Punkten zurück. Dies ist die Breite des Begrenzungsrahmens des Elements, wenn das Element nicht gedreht wird.
preconcatenateTransform(transform)ShapeVerkettet die angegebene Transformation mit der vorhandenen Transformation des Seitenelements.
remove()voidEntfernt das Seitenelement.
removeLink()voidEntfernt Link.
replaceWithImage(blobSource)ImageErsetzt diese Form durch ein von BlobSource bereitgestelltes Bild.
replaceWithImage(blobSource, crop)ImageErsetzt diese Form durch ein von BlobSource bereitgestelltes Bild.
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)ImageErsetzt diese Form durch das Bild eines Google Tabellen-Diagramms.
scaleHeight(ratio)ShapeSkaliert die Höhe des Elements um das angegebene Verhältnis.
scaleWidth(ratio)ShapeSkaliert die Breite des Elements um das angegebene Verhältnis.
select()voidWählt nur PageElement in der aktiven Präsentation aus und entfernt alle vorherigen Auswahlen.
select(replace)voidWählt PageElement in der aktiven Präsentation aus.
sendBackward()ShapeVersetzt das Seitenelement auf der Seite um ein Element nach hinten.
sendToBack()ShapeVersendet das Seitenelement an das Ende der Seite.
setContentAlignment(contentAlignment)ShapeLegt den ContentAlignment des Texts in der Form fest.
setDescription(description)ShapeLegt die Alt-Textbeschreibung des Seitenelements fest.
setHeight(height)ShapeLegt die Höhe des Elements in Punkten fest. Das ist die Höhe des Begrenzungsrahmens des Elements, wenn das Element nicht gedreht wird.
setLeft(left)ShapeLegt die horizontale Position des Elements in Punkten fest, gemessen von der linken oberen Ecke der Seite, wenn das Element nicht gedreht wird.
setLinkSlide(slideIndex)LinkLegt mithilfe des nullbasierten Index der Folie einen Link auf den angegebenen Slide fest.
setLinkSlide(slide)LinkLegt ein Link für die angegebene Slide fest. Die Verknüpfung wird durch die angegebene Folien-ID festgelegt.
setLinkSlide(slidePosition)LinkLegt einen Link auf den angegebenen Slide anhand der relativen Position der Folie fest.
setLinkUrl(url)LinkLegt einen Link auf den angegebenen nicht leeren URL-String fest.
setRotation(angle)ShapeLegt den Drehwinkel des Elements im Uhrzeigersinn um seinen Mittelpunkt in Grad fest.
setTitle(title)ShapeLegt den Alt-Texttitel des Seitenelements fest
setTop(top)ShapeLegt die vertikale Position des Elements in Punkten fest, gemessen von der linken oberen Ecke der Seite, wenn das Element nicht gedreht wird.
setTransform(transform)ShapeLegt die Transformation des Seitenelements mit der angegebenen Transformation fest.
setWidth(width)ShapeLegt die Breite des Elements in Punkten fest. Das ist die Breite des Begrenzungsrahmens des Elements, wenn das Element nicht gedreht wird.

Detaillierte Dokumentation

alignOnPage(alignmentPosition)

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

Parameter

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

Return

Shape: Dieses Seitenelement für die Verkettung.


bringForward()

Bringt das Seitenelement auf der Seite um ein Element nach vorn.

Das Seitenelement darf nicht in einer Gruppe sein.

Return

Shape: Dieses Seitenelement für die Verkettung.

Autorisierung

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

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

bringToFront()

Bringt das Seitenelement in den Vordergrund der Seite.

Das Seitenelement darf nicht in einer Gruppe sein.

Return

Shape: Dieses Seitenelement für die Verkettung.

Autorisierung

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

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

duplicate()

Dupliziert das Seitenelement.

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

Return

PageElement: Das neue Duplikat dieses Seitenelements.

Autorisierung

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

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

getAutofit()

Gibt den Autofit des Texts innerhalb dieser Form zurück. Dies ist null, wenn die Form keinen Text zulässt.

Return

Autofit: Die automatische Anpassung des Textes in 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

getBorder()

Gibt das Border der Form zurück.

Return

Border: Rahmeneinstellung 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

getConnectionSites()

Gibt die Liste der ConnectionSites im Seitenelement zurück. Wenn das Seitenelement keine Verbindungswebsites hat, wird eine leere Liste zurückgegeben.

Return

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

Autorisierung

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

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

getContentAlignment()

Gibt den ContentAlignment des Texts in der Form zurück

Return

ContentAlignment: Textausrichtung 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 alternative Textbeschreibung des Seitenelements zurück Die Beschreibung wird mit dem Titel kombiniert, um Alt-Text anzuzeigen und zu lesen.

Return

String: Die alternative Textbeschreibung des Seitenelements.

Autorisierung

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

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

getFill()

Gibt das Fill der Form zurück.

Return

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 das Element nicht gedreht wird.

Diese Methode ist nicht mit allen Seitenelementen kompatibel. Informationen dazu, welche Seitenelemente mit dieser Methode nicht kompatibel sind, finden Sie unter Größen- und Positionierungsbeschränkungen.

Return

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

Autorisierung

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

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

getInherentHeight()

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

Die Transformation des Seitenelements richtet sich nach seiner inhärenten Größe. Verwenden Sie die inhärente Größe in Verbindung mit der Transformation des Elements, um das endgültige visuelle Erscheinungsbild des Elements zu bestimmen.

Return

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

Autorisierung

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

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

getInherentWidth()

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

Die Transformation des Seitenelements richtet sich nach seiner inhärenten Größe. Verwenden Sie die inhärente Größe in Verbindung mit der Transformation des Elements, um das endgültige visuelle Erscheinungsbild des Elements zu bestimmen.

Return

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

Autorisierung

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

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

getLeft()

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

Return

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

Autorisierung

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

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

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

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

Return

Link

Autorisierung

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

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

getObjectId()

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

Return

String: Die eindeutige ID für dieses Objekt.

Autorisierung

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

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

getPageElementType()

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

Return

PageElementType: der Typ des Seitenelements

Autorisierung

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

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

getParentGroup()

Gibt die Gruppe zurück, zu der dieses Seitenelement gehört, oder null, wenn sich das Element nicht in einer Gruppe befindet.

Return

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

Autorisierung

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

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

getParentPage()

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

Return

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

Autorisierung

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

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

getParentPlaceholder()

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

Return

PageElement: Das übergeordnete Seitenelement dieses Formplatzhalters oder null, wenn die Form kein Platzhalter ist oder kein übergeordnetes Element hat.

Autorisierung

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

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

getPlaceholderIndex()

Gibt den Platzhalterindex der Form zurück Wenn zwei oder mehr Instanzen desselben Platzhaltertyps auf derselben Seite vorhanden sind, haben jede einen eigenen eindeutigen Indexwert. Gibt null zurück, wenn die Form kein Platzhalter ist.

Return

Integer: der Platzhalterindex der 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 kein Platzhalter ist.

Return

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 Drehwinkel des Elements im Uhrzeigersinn um seinen Mittelpunkt in Grad zurück, wobei null Grad keine Drehung bedeutet.

Return

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

Autorisierung

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

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

getShapeType()

Gibt den Typ der Form zurück

Return

ShapeType: Der Typ dieser Form.


getText()

Gibt den Textinhalt der Form zurück

Text innerhalb einer Form endet immer mit einem Zeilenumbruch.

Return

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, um Alt-Text anzuzeigen und zu lesen.

Return

String: Der alternative Texttitel des Seitenelements.

Autorisierung

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

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

getTop()

Ruft die vertikale Position des Elements in Punkten ab, gemessen von der linken oberen Ecke der Seite, wenn das Element nicht gedreht wird.

Return

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

Autorisierung

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

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

getTransform()

Gibt die Transformation des Seitenelements zurück.

Die visuelle Darstellung des Seitenelements wird durch seine absolute Transformation bestimmt. Um die absolute Transformation zu berechnen, verketten Sie die Transformation eines Seitenelements mit den Transformationen aller übergeordneten Gruppen. Wenn das Seitenelement nicht in einer Gruppe ist, entspricht seine absolute Transformation dem Wert in diesem Feld.

Return

AffineTransform: Die Transformation des Seitenelements.

Autorisierung

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

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

getWidth()

Gibt die Breite des Elements in Punkten zurück. Dies ist die Breite des Begrenzungsrahmens des Elements, wenn das Element nicht gedreht wird.

Diese Methode ist nicht mit allen Seitenelementen kompatibel. Informationen dazu, welche Seitenelemente mit dieser Methode nicht kompatibel sind, finden Sie unter Größen- und Positionierungsbeschränkungen.

Return

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

Autorisierung

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

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

preconcatenateTransform(transform)

Verkettet die angegebene Transformation mit der vorhandenen Transformation des Seitenelements.

newTransform = argument * existingTransform

So verschieben Sie beispielsweise Seitenelemente um 36 Punkte nach links:

element.preconcatenateTransform(SlidesApp.newAffineTransformBuilder()
    .setTranslateX(-36.0)
    .build());

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

Parameter

NameTypBeschreibung
transformAffineTransformDie Transformation, die mit der Transformation dieses Seitenelements verkettet werden soll.

Return

Shape: Dieses Seitenelement für die Verkettung.

Autorisierung

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

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

remove()

Entfernt das Seitenelement.

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

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

Autorisierung

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

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

Entfernt Link.

shape.removeLink();

replaceWithImage(blobSource)

Ersetzt diese Form durch ein von BlobSource bereitgestelltes Bild.

Das Bild wird einmal beim Einfügen aus dem bereitgestellten BlobSource abgerufen und eine Kopie wird gespeichert, um sie in der Präsentation anzuzeigen. Bilder müssen kleiner als 50 MB sein und dürfen 25 Megapixel nicht überschreiten. Außerdem müssen sie im PNG-, JPEG- oder GIF-Format vorliegen.

Um das Seitenverhältnis des Bildes beizubehalten, wird das Bild in Bezug auf die Größe der vorhandenen Form skaliert und zentriert.

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

NameTypBeschreibung
blobSourceBlobSourceDie Bilddaten.

Return

Image: Der Image, der 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

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 zur Anzeige in der Präsentation gespeichert. Bilder müssen kleiner als 50 MB sein und dürfen 25 Megapixel nicht überschreiten. Außerdem müssen sie im PNG-, JPEG- oder GIF-Format vorliegen.

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

NameTypBeschreibung
blobSourceBlobSourceDie Bilddaten.
cropBooleanBei true wird das Bild auf die Größe der vorhandenen Form zugeschnitten. Andernfalls wird das Bild skaliert und zentriert.

Return

Image: Der Image, der 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

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 zur Anzeige in der Präsentation gespeichert. Bilder müssen kleiner als 50 MB sein und dürfen 25 Megapixel nicht überschreiten. Außerdem müssen sie im PNG-, JPEG- oder GIF-Format vorliegen.

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

Um das Seitenverhältnis des Bildes beizubehalten, wird das Bild in Bezug auf die Größe der vorhandenen Form skaliert und zentriert.

Parameter

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

Return

Image: Der Image, der 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

replaceWithImage(imageUrl, crop)

Ersetzt diese Form durch ein Bild.

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

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

Parameter

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

Return

Image: Der Image, der 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

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.

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

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

Return

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 das Bild eines Google Tabellen-Diagramms.

Um das Seitenverhältnis des Google Tabellen-Diagramms beizubehalten, wird das Diagrammbild in Bezug auf die Größe der vorhandenen Form skaliert und 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

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

Return

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 seines Begrenzungsrahmens, wenn das Element nicht gedreht wird.

Diese Methode ist nicht mit allen Seitenelementen kompatibel. Informationen dazu, welche Seitenelemente mit dieser Methode nicht kompatibel sind, finden Sie unter Größen- und Positionierungsbeschränkungen.

Parameter

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

Return

Shape: Dieses Seitenelement für die Verkettung.

Autorisierung

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

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

scaleWidth(ratio)

Skaliert die Breite des Elements um das angegebene Verhältnis. Die Breite des Elements ist die Breite seines Begrenzungsrahmens, wenn das Element nicht gedreht wird.

Diese Methode ist nicht mit allen Seitenelementen kompatibel. Informationen dazu, welche Seitenelemente mit dieser Methode nicht kompatibel sind, finden Sie unter Größen- und Positionierungsbeschränkungen.

Parameter

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

Return

Shape: Dieses Seitenelement für die Verkettung.

Autorisierung

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

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

select()

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

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

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

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

Autorisierung

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

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

select(replace)

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

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

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

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

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

  1. Der übergeordnete Page des PageElement-Objekts muss current page selection sein.
  2. Es dürfen nicht mehrere Page-Objekte ausgewählt sein.

Wir empfehlen, zuerst das übergeordnete Element Page mithilfe von Page.selectAsCurrentPage() und dann die Seitenelemente auf dieser Seite auszuwählen.

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

Parameter

NameTypBeschreibung
replaceBooleanBei true ersetzt die Auswahl jede vorherige Auswahl. Andernfalls wird die Auswahl zur vorherigen Auswahl hinzugefügt.

Autorisierung

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

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

sendBackward()

Versetzt das Seitenelement auf der Seite um ein Element nach hinten.

Das Seitenelement darf nicht in einer Gruppe sein.

Return

Shape: Dieses Seitenelement für die Verkettung.

Autorisierung

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

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

sendToBack()

Versendet das Seitenelement an das Ende der Seite.

Das Seitenelement darf nicht in einer Gruppe sein.

Return

Shape: Dieses Seitenelement für die Verkettung.

Autorisierung

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

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

setContentAlignment(contentAlignment)

Legt den ContentAlignment des Texts in der Form fest.

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

Parameter

NameTypBeschreibung
contentAlignmentContentAlignmentDie festzulegende Ausrichtung.

Return

Shape: Diese Form für Verkettungen.

Autorisierung

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

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

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

NameTypBeschreibung
descriptionStringDer String, auf den die Beschreibung des alternativen Texts gesetzt werden soll.

Return

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. Das ist die Höhe des Begrenzungsrahmens des Elements, wenn das Element nicht gedreht wird.

Diese Methode ist nicht mit allen Seitenelementen kompatibel. Informationen dazu, welche Seitenelemente mit dieser Methode nicht kompatibel sind, finden Sie unter Größen- und Positionierungsbeschränkungen.

Parameter

NameTypBeschreibung
heightNumberDie neu festzulegende Höhe dieses Seitenelements in Punkten.

Return

Shape: Dieses Seitenelement für die Verkettung.

Autorisierung

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

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

setLeft(left)

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

Parameter

NameTypBeschreibung
leftNumberDie neu festzulegende horizontale Position in Punkten.

Return

Shape: Dieses Seitenelement für die Verkettung.

Autorisierung

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

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

setLinkSlide(slideIndex)

Legt mithilfe des nullbasierten Index der Folie einen Link auf den angegebenen Slide fest.

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

Parameter

NameTypBeschreibung
slideIndexIntegerDer nullbasierte Index für die Folie.

Return

Link – der 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 für die angegebene Slide fest. Die Verknüpfung wird durch die angegebene Folien-ID festgelegt.

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

Parameter

NameTypBeschreibung
slideSlideDie zu verknüpfende Slide.

Return

Link – der 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 einen Link auf den angegebenen Slide anhand der relativen Position der Folie fest.

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

Parameter

NameTypBeschreibung
slidePositionSlidePositionDie relative SlidePosition.

Return

Link – der 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

NameTypBeschreibung
urlStringDer URL-String.

Return

Link – der 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 Drehwinkel des Elements im Uhrzeigersinn um seinen Mittelpunkt in Grad fest.

Diese Methode ist nicht mit allen Seitenelementen kompatibel. Informationen dazu, welche Seitenelemente mit dieser Methode nicht kompatibel sind, finden Sie unter Größen- und Positionierungsbeschränkungen.

Parameter

NameTypBeschreibung
angleNumberDer neu festzulegende Drehwinkel im Uhrzeigersinn in Grad.

Return

Shape: Dieses Seitenelement für die Verkettung.

Autorisierung

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

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

setTitle(title)

Legt den Alt-Texttitel des Seitenelements fest

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

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

Parameter

NameTypBeschreibung
titleStringZeichenfolge, auf die der Titel des Alt-Texts gesetzt werden soll

Return

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, wenn das Element nicht gedreht wird.

Parameter

NameTypBeschreibung
topNumberDie neu festzulegende vertikale Position in Punkten.

Return

Shape: Dieses Seitenelement für die Verkettung.

Autorisierung

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

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

setTransform(transform)

Legt die Transformation des Seitenelements mit der angegebenen Transformation fest.

Wenn Sie die Transformation einer Gruppe aktualisieren, ändert sich auch die absolute Transformation der Seitenelemente in dieser Gruppe. Dadurch kann sich ihr visuelles Erscheinungsbild ändern.

Wenn Sie die Transformation eines Seitenelements ändern, das sich in einer Gruppe befindet, ändert sich nur die Transformation dieses Seitenelements. Sie wirkt sich nicht auf die Transformationen der Gruppe oder anderer Seitenelemente in der Gruppe aus.

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

Parameter

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

Return

Shape: Dieses Element für Verkettungen.

Autorisierung

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

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

setWidth(width)

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

Diese Methode ist nicht mit allen Seitenelementen kompatibel. Informationen dazu, welche Seitenelemente mit dieser Methode nicht kompatibel sind, finden Sie unter Größen- und Positionierungsbeschränkungen.

Parameter

NameTypBeschreibung
widthNumberDie neue Breite dieses Seitenelements, die in Punkten festgelegt werden soll.

Return

Shape: Dieses Seitenelement für die Verkettung.

Autorisierung

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

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