Diese Seite wurde von der Cloud Translation API übersetzt.

Class Layout

Ein Layout in einer Präsentation.

Jedes Layout dient als Vorlage für Folien, die von ihm übernommen werden. Sie bestimmt, wie die Inhalte angeordnet und gestaltet.

Methoden

Methode	Rückgabetyp	Kurzbeschreibung
`getBackground()`	`PageBackground`	Ruft den Hintergrund der Seite ab.
`getColorScheme()`	`ColorScheme`	Ruft die `ColorScheme` ab, die der Seite zugeordnet ist.
`getGroups()`	`Group[]`	Gibt die Liste der `Group`-Objekte auf der Seite zurück
`getImages()`	`Image[]`	Gibt die Liste der `Image`-Objekte auf der Seite zurück
`getLayoutName()`	`String`	Ruft den Namen des Layouts ab.
`getLines()`	`Line[]`	Gibt die Liste der `Line`-Objekte auf der Seite zurück
`getMaster()`	`Master`	Ruft den Master ab, auf dem das Layout basiert.
`getObjectId()`	`String`	Ruft die eindeutige ID für die Seite ab.
`getPageElementById(id)`	`PageElement`	Gibt das `PageElement` auf der Seite mit der angegebenen ID oder `null` zurück, wenn keine vorhanden ist.
`getPageElements()`	`PageElement[]`	Gibt die Liste der `PageElement`-Objekte zurück, die auf der Seite gerendert wurden.
`getPageType()`	`PageType`	Ruft den Typ der Seite ab.
`getPlaceholder(placeholderType)`	`PageElement`	Gibt das Platzhalterobjekt `PageElement` für eine angegebene `PlaceholderType` oder `null`, wenn kein übereinstimmender Platzhalter vorhanden ist.
`getPlaceholder(placeholderType, placeholderIndex)`	`PageElement`	Gibt das Platzhalterobjekt `PageElement` für eine angegebene `PlaceholderType` zurück und ein Platzhalterindex oder `null`, wenn der Platzhalter nicht vorhanden ist.
`getPlaceholders()`	`PageElement[]`	Gibt die Liste der Platzhalterobjekte vom Typ `PageElement` auf der Seite zurück.
`getShapes()`	`Shape[]`	Gibt die Liste der `Shape`-Objekte auf der Seite zurück
`getSheetsCharts()`	`SheetsChart[]`	Gibt die Liste der `SheetsChart`-Objekte auf der Seite zurück
`getTables()`	`Table[]`	Gibt die Liste der `Table`-Objekte auf der Seite zurück
`getVideos()`	`Video[]`	Gibt die Liste der `Video`-Objekte auf der Seite zurück
`getWordArts()`	`WordArt[]`	Gibt die Liste der `WordArt`-Objekte auf der Seite zurück
`group(pageElements)`	`Group`	Gruppiert alle angegebenen Seitenelemente.
`insertGroup(group)`	`Group`	Fügt eine Kopie des bereitgestellten `Group` auf der Seite ein.
`insertImage(blobSource)`	`Image`	Fügt oben links auf der Seite ein Bild in der Standardgröße aus der angegebenen Bild-Blob.
`insertImage(blobSource, left, top, width, height)`	`Image`	Fügt auf der Seite ein Bild mit der angegebenen Position und Größe aus dem angegebenen Bild-Blob ein.
`insertImage(image)`	`Image`	Fügt eine Kopie des bereitgestellten `Image` auf der Seite ein.
`insertImage(imageUrl)`	`Image`	Fügt oben links auf der Seite ein Bild in einer Standardgröße aus der angegebenen URL ein.
`insertImage(imageUrl, left, top, width, height)`	`Image`	Fügt ein Bild mit der angegebenen Position und Größe aus der angegebenen URL auf der Seite ein.
`insertLine(line)`	`Line`	Fügt eine Kopie des bereitgestellten `Line` auf der Seite ein.
`insertLine(lineCategory, startConnectionSite, endConnectionSite)`	`Line`	Fügt auf der Seite eine Linie ein, die zwei `connection sites` verbindet.
`insertLine(lineCategory, startLeft, startTop, endLeft, endTop)`	`Line`	Fügt auf der Seite eine Zeile ein.
`insertPageElement(pageElement)`	`PageElement`	Fügt eine Kopie des bereitgestellten `PageElement` auf der Seite ein.
`insertShape(shape)`	`Shape`	Fügt eine Kopie des bereitgestellten `Shape` auf der Seite ein.
`insertShape(shapeType)`	`Shape`	Fügt eine Form auf der Seite ein.
`insertShape(shapeType, left, top, width, height)`	`Shape`	Fügt eine Form auf der Seite ein.
`insertSheetsChart(sourceChart)`	`SheetsChart`	Fügt ein Google Tabellen-Diagramm auf der Seite ein.
`insertSheetsChart(sourceChart, left, top, width, height)`	`SheetsChart`	Fügt ein Google Tabellen-Diagramm mit der angegebenen Position und Größe auf der Seite ein.
`insertSheetsChart(sheetsChart)`	`SheetsChart`	Fügt eine Kopie des bereitgestellten `SheetsChart` auf der Seite ein.
`insertSheetsChartAsImage(sourceChart)`	`Image`	Fügt ein Google Tabellen-Diagramm als `Image` auf der Seite ein.
`insertSheetsChartAsImage(sourceChart, left, top, width, height)`	`Image`	Fügt ein Google Tabellen-Diagramm als `Image` auf der Seite mit der angegebenen Position und Größe.
`insertTable(numRows, numColumns)`	`Table`	Fügt auf der Seite eine Tabelle ein.
`insertTable(numRows, numColumns, left, top, width, height)`	`Table`	Fügt eine Tabelle mit der angegebenen Position und Größe auf der Seite ein.
`insertTable(table)`	`Table`	Fügt eine Kopie des bereitgestellten `Table` auf der Seite ein.
`insertTextBox(text)`	`Shape`	Fügt das Textfeld `Shape` ein, das den angegebenen String auf der Seite enthält.
`insertTextBox(text, left, top, width, height)`	`Shape`	Fügt das Textfeld `Shape` ein, das den angegebenen String auf der Seite enthält.
`insertVideo(videoUrl)`	`Video`	Fügt oben links auf der Seite ein Video in Standardgröße ein.
`insertVideo(videoUrl, left, top, width, height)`	`Video`	Fügt ein Video mit der angegebenen Position und Größe auf der Seite ein.
`insertVideo(video)`	`Video`	Fügt eine Kopie des bereitgestellten `Video` auf der Seite ein.
`insertWordArt(wordArt)`	`WordArt`	Fügt eine Kopie des bereitgestellten `WordArt` auf der Seite ein.
`remove()`	`void`	Entfernt die Seite.
`replaceAllText(findText, replaceText)`	`Integer`	Ersetzt alle Vorkommen von Text, der mit "Text suchen" übereinstimmt, durch "Text ersetzen".
`replaceAllText(findText, replaceText, matchCase)`	`Integer`	Ersetzt alle Vorkommen von Text, der mit "Text suchen" übereinstimmt, durch "Text ersetzen".
`selectAsCurrentPage()`	`void`	Wählt das `Page` in der aktiven Präsentation als `current page selection` aus und entfernt die vorherige Auswahl.

Detaillierte Dokumentation

`getBackground()`

Ruft den Hintergrund der Seite ab.

Rückflug

PageBackground: Der Hintergrund 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

`getColorScheme()`

Ruft die ColorScheme ab, die der Seite zugeordnet ist.

Rückflug

ColorScheme: Das Farbschema 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

`getGroups()`

Gibt die Liste der Group-Objekte auf der Seite zurück

Rückflug

Group[]

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

`getImages()`

Gibt die Liste der Image-Objekte auf der Seite zurück

Rückflug

Image[]

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

`getLayoutName()`

Ruft den Namen des Layouts ab.

Rückflug

String

Autorisierung

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

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

`getLines()`

Gibt die Liste der Line-Objekte auf der Seite zurück

Rückflug

Line[]

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

`getMaster()`

Ruft den Master ab, auf dem das Layout basiert.

Rückflug

Master

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()`

Ruft die eindeutige ID für die Seite ab. Die von Seiten und Seitenelementen verwendeten Objekt-IDs sind identisch -Namespace auf sie zugegriffen werden.

Rückflug

String

Autorisierung

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

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

`getPageElementById(id)`

Gibt das PageElement auf der Seite mit der angegebenen ID oder null zurück, wenn keine vorhanden ist.

Parameter

Name	Typ	Beschreibung
`id`	`String`	Die ID des abgerufenen Seitenelements.

Rückflug

PageElement: Das Seitenelement mit der angegebenen ID.

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

`getPageElements()`

Gibt die Liste der PageElement-Objekte zurück, die auf der Seite gerendert wurden.

Rückflug

PageElement[]

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

`getPageType()`

Ruft den Typ der Seite ab.

Rückflug

PageType: Der Seitentyp.

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

`getPlaceholder(placeholderType)`

Gibt das Platzhalterobjekt PageElement für eine angegebene PlaceholderType oder null, wenn kein übereinstimmender Platzhalter vorhanden ist.

Sind mehrere Platzhalter vom gleichen Typ vorhanden, wird der mit der Mindestanzahl von Platzhalterindex. Wenn es mehrere übereinstimmende Platzhalter mit demselben Index gibt, wird Folgendes zurückgegeben: den ersten Platzhalter aus der Seitenelementsammlung der Seite.

var slide = SlidesApp.getActivePresentation().getSlides()[0];
var placeholder = slide.getPlaceholder(SlidesApp.PlaceholderType.CENTERED_TITLE);

Parameter

Name	Typ	Beschreibung
`placeholderType`	`PlaceholderType`

Rückflug

PageElement

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

`getPlaceholder(placeholderType, placeholderIndex)`

Gibt das Platzhalterobjekt PageElement für eine angegebene PlaceholderType zurück und ein Platzhalterindex oder null, wenn der Platzhalter nicht vorhanden ist.

Sind mehrere Platzhalter mit demselben Typ und Index vorhanden, wird der erste Platzhalter aus der Seitenelementsammlung der Seite.

var slide = SlidesApp.getActivePresentation().getSlides()[0];
var placeholder = slide.getPlaceholder(SlidesApp.PlaceholderType.CENTERED_TITLE, 0);

Parameter

Name	Typ	Beschreibung
`placeholderType`	`PlaceholderType`
`placeholderIndex`	`Integer`

Rückflug

PageElement

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

`getPlaceholders()`

Gibt die Liste der Platzhalterobjekte vom Typ PageElement auf der Seite zurück.

var master = SlidesApp.getActivePresentation().getMasters()[0];
Logger.log('Number of placeholders in the master: ' + master.getPlaceholders().length);

Rückflug

PageElement[]

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

`getShapes()`

Gibt die Liste der Shape-Objekte auf der Seite zurück

Rückflug

Shape[]

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

`getSheetsCharts()`

Gibt die Liste der SheetsChart-Objekte auf der Seite zurück

Rückflug

SheetsChart[]

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

`getTables()`

Gibt die Liste der Table-Objekte auf der Seite zurück

Rückflug

Table[]

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

`getVideos()`

Gibt die Liste der Video-Objekte auf der Seite zurück

Rückflug

Video[]

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

`getWordArts()`

Gibt die Liste der WordArt-Objekte auf der Seite zurück

Rückflug

WordArt[]

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

`group(pageElements)`

Gruppiert alle angegebenen Seitenelemente.

Es sollte mindestens zwei Seitenelemente auf derselben Seite geben, die sich nicht bereits in einer anderen befinden Gruppe. Einige Seitenelemente wie Videos, Tables und placeholder Shapes können nicht gruppiert werden.

Parameter

Name	Typ	Beschreibung
`pageElements`	`PageElement[]`	Die zu gruppierenden Elemente.

Rückflug

Group: Die neue Gruppe.

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

`insertGroup(group)`

Fügt eine Kopie des bereitgestellten Group auf der Seite ein.

Die Position des eingefügten Elements auf dieser Seite wird anhand der Methode Position auf der jeweiligen Seite.

Wenn das angegebene Element ein Platzhalter ist, der aus der aktuellen Präsentation kopiert wird, Eigenschaften, die von Master- oder Layoutseiten übernommen werden, werden auch für das eingefügte Element übernommen.

Wenn das angegebene Element ein Platzhalter ist, der aus einer anderen Präsentation kopiert wird, Eigenschaften, die von Master- oder Layoutseiten übernommen werden, werden in das Element der Quelle kopiert. zu präsentieren.

// Copy a group between presentations.
var otherPresentationSlide = SlidesApp.openById('presentationId').getSlides()[0];
var currentPresentationSlide = SlidesApp.getActivePresentation().getSlides()[0];
var group = otherPresentationSlide.getGroups()[0];
currentPresentationSlide.insertGroup(group); // Also available for Layout, Master, and Page.

Parameter

Name	Typ	Beschreibung
`group`	`Group`	Die Gruppe, die kopiert und eingefügt werden soll.

Rückflug

Group: Die eingefügte Gruppe.

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

`insertImage(blobSource)`

Fügt oben links auf der Seite ein Bild in der Standardgröße aus der angegebenen Bild-Blob.

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 slide = SlidesApp.getActivePresentation().getSlides()[0];
// Get the Drive image file with the given ID.
var image = DriveApp.getFileById(fileId);
slide.insertImage(image);

Parameter

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

Rückflug

Image: Das eingefügte Bild.

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

`insertImage(blobSource, left, top, width, height)`

Fügt auf der Seite ein Bild mit der angegebenen Position und Größe aus dem angegebenen Bild-Blob ein.

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. in die angegebene Größe ein.

var slide = SlidesApp.getActivePresentation().getSlides()[0];
// Get the Drive image file with the given ID.
var image = DriveApp.getFileById(fileId);
var position = {left: 0, top: 0};
var size = {width: 300, height: 100};
slide.insertImage(image, position.left, position.top, size.width, size.height);

Parameter

Name	Typ	Beschreibung
`blobSource`	`BlobSource`	Die Bilddaten.
`left`	`Number`	Die horizontale Position des Bilds in Punkten, gemessen von der oberen linken Ecke aus der Seite.
`top`	`Number`	Die vertikale Position des Bilds in Punkten, gemessen von der oberen linken Ecke des auf der Seite.
`width`	`Number`	Die Breite des Bilds in Punkten.
`height`	`Number`	Die Höhe des Bilds in Punkten.

Rückflug

Image: Das eingefügte Bild.

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

`insertImage(image)`

Fügt eine Kopie des bereitgestellten Image auf der Seite ein.

Die Position der eingefügten Bilder auf dieser Seite wird anhand der Position des Quellbilds bestimmt. auf der entsprechenden Seite.

Wenn das bereitgestellte Bild ein Platzhalter ist, der aus der aktuellen Präsentation kopiert wird, Eigenschaften, die von Master- oder Layoutseiten übernommen werden, werden auch für das eingefügte Bild übernommen.

Wenn das bereitgestellte Bild ein Platzhalter ist, der aus einer anderen Präsentation kopiert wird, Eigenschaften, die von Master- oder Layoutseiten übernommen werden, werden aus der Quelle in das Bild kopiert. zu präsentieren. Wenn das kopierte Platzhalterbild leer ist, wird im Ziel nichts eingefügt zu präsentieren.

// Copy an image between presentations.
var otherPresentationSlide = SlidesApp.openById('presentationId').getSlides()[0];
var currentPresentationSlide = SlidesApp.getActivePresentation().getSlides()[0];
var image = otherPresentationSlide.getImages[0];
currentPresentationSlide.insertImage(image);

Parameter

Name	Typ	Beschreibung
`image`	`Image`	Das Bild, das kopiert und eingefügt werden soll.

Rückflug

Image: Das eingefügte Bild.

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

`insertImage(imageUrl)`

Fügt oben links auf der Seite ein Bild in einer Standardgröße aus der angegebenen URL ein.

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

Parameter

Name	Typ	Beschreibung
`imageUrl`	`String`	Die Bild-URL.

Rückflug

Image: Das eingefügte Bild.

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

`insertImage(imageUrl, left, top, width, height)`

Fügt ein Bild mit der angegebenen Position und Größe aus der angegebenen URL auf der Seite ein.

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. in die angegebene Größe ein.

Parameter

Name	Typ	Beschreibung
`imageUrl`	`String`	Die Bild-URL.
`left`	`Number`	Die horizontale Position des Bilds in Punkten, gemessen von der oberen linken Ecke aus der Seite.
`top`	`Number`	Die vertikale Position des Bilds in Punkten, gemessen von der oberen linken Ecke des auf der Seite.
`width`	`Number`	Die Breite des Bilds in Punkten.
`height`	`Number`	Die Höhe des Bilds in Punkten.

Rückflug

Image: Das eingefügte Bild.

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

`insertLine(line)`

Fügt eine Kopie des bereitgestellten Line auf der Seite ein.

Die Position des eingefügten Elements auf dieser Seite wird anhand der Methode Position auf der jeweiligen Seite.

// Copy a line between presentations.
var otherPresentationSlide = SlidesApp.openById('presentationId').getSlides()[0];
var currentPresentationSlide = SlidesApp.getActivePresentation().getSlides()[0];
var line = otherPresentationSlide.getLines[0];
currentPresentationSlide.insertLine(line);

Parameter

Name	Typ	Beschreibung
`line`	`Line`	Die zu kopierende und einzufügende Zeile.

Rückflug

Line: Die eingefügte Zeile.

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

`insertLine(lineCategory, startConnectionSite, endConnectionSite)`

Fügt auf der Seite eine Linie ein, die zwei connection sites verbindet. Die beiden müssen sich auf dieser Seite befinden.

// Insert a line in the first slide of the presentation connecting two shapes.
var slide = SlidesApp.getActivePresentation().getSlides()[0];
var shape1 = slide.insertShape(SlidesApp.ShapeType.RECTANGLE);
var shape2 = slide.insertShape(SlidesApp.ShapeType.CLOUD);
slide.insertLine(
    SlidesApp.LineCategory.BENT,
    shape1.getConnectionSites()[0],
    shape2.getConnectionSites()[1]);

Parameter

Name	Typ	Beschreibung
`lineCategory`	`LineCategory`	Die Kategorie der einzufügenden Zeile.
`startConnectionSite`	`ConnectionSite`	Der Verbindungsstandort, an dem der Anfang der Linie verbunden werden soll.
`endConnectionSite`	`ConnectionSite`	Der Verbindungsstandort, an dem das Ende der Linie verbunden werden soll.

Rückflug

Line: Die eingefügte Zeile.

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

`insertLine(lineCategory, startLeft, startTop, endLeft, endTop)`

Fügt auf der Seite eine Zeile ein.

// Insert a line in the first slide of the presentation.
var slide = SlidesApp.getActivePresentation().getSlides()[0];
var startPoint = {left: 10, top: 10};
var endPoint = {left: 40, top: 40};
slide.insertLine(
    SlidesApp.LineCategory.STRAIGHT,
    startPoint.left,
    startPoint.top,
    endPoint.left,
    endPoint.top);

Parameter

Name	Typ	Beschreibung
`lineCategory`	`LineCategory`	Die Kategorie der einzufügenden Zeile.
`startLeft`	`Number`	Die horizontale Position des Startpunkts der Linie, gemessen in Punkten aus der oberen linken Ecke der Seite aus.
`startTop`	`Number`	Die vertikale Position des Startpunkts der Linie, gemessen in Punkten von in der oberen linken Ecke der Seite.
`endLeft`	`Number`	Die horizontale Position des Endpunkts der Linie, gemessen in Punkten von in der oberen linken Ecke der Seite.
`endTop`	`Number`	Die vertikale Position des Endpunkts der Linie, gemessen in Punkten vom in der linken oberen Ecke der Seite.

Rückflug

Line: Die eingefügte Zeile.

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

`insertPageElement(pageElement)`

Fügt eine Kopie des bereitgestellten PageElement auf der Seite ein.

Die Position des eingefügten Elements auf dieser Seite wird anhand der Methode Position auf der jeweiligen Seite.

// Copy a page element between presentations.
var otherPresentationSlide = SlidesApp.openById('presentationId').getSlides()[0];
var currentPresentationSlide = SlidesApp.getActivePresentation().getSlides()[0];
var pageElement = otherPresentationSlide.getPageElements()[0];

// Also available for Layout, Master, and Page.
currentPresentationSlide.insertPageElement(pageElement);

Parameter

Name	Typ	Beschreibung
`pageElement`	`PageElement`	Das Seitenelement, das kopiert und eingefügt werden soll.

Rückflug

PageElement: Das eingefügte 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

`insertShape(shape)`

Fügt eine Kopie des bereitgestellten Shape auf der Seite ein.

Die Position des eingefügten Elements auf dieser Seite wird anhand der Methode Position auf der jeweiligen Seite.

// Copy a shape between presentations.
var otherPresentationSlide = SlidesApp.openById('presentationId').getSlides()[0];
var currentPresentationSlide = SlidesApp.getActivePresentation().getSlides()[0];
var shape = otherPresentationSlide.getShapes[0];
currentPresentationSlide.insertShape(shape); // Also available for Layout, Master, and Page.

Parameter

Name	Typ	Beschreibung
`shape`	`Shape`	Die Form, die kopiert und eingefügt werden soll.

Rückflug

Shape: Die eingefügte 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

`insertShape(shapeType)`

Fügt eine Form auf der Seite ein.

Die Form wird mit einer Standardgröße oben links auf der Seite eingefügt.

// Insert a shape in the first slide of the presentation.
var slide = SlidesApp.getActivePresentation().getSlides()[0];

// Also available for Layout, Master, and Page.
slide.insertShape(SlidesApp.ShapeType.RECTANGLE);

Parameter

Name	Typ	Beschreibung
`shapeType`	`ShapeType`	Der Typ der einzufügenden Form.

Rückflug

Shape: Die eingefügte 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

`insertShape(shapeType, left, top, width, height)`

Fügt eine Form auf der Seite ein.

Parameter

Name	Typ	Beschreibung
`shapeType`	`ShapeType`	Der Typ der einzufügenden Form.
`left`	`Number`	Die horizontale Position der Form, gemessen von der oberen linken Ecke des Seite.
`top`	`Number`	Die vertikale Position der Form, gemessen von der oberen linken Ecke der Seite.
`width`	`Number`	Breite der Form.
`height`	`Number`	Höhe der Form

Rückflug

Shape: Die eingefügte 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

`insertSheetsChart(sourceChart)`

Fügt ein Google Tabellen-Diagramm auf der Seite ein.

Das Diagramm wird mit einer Standardgröße oben links auf der Seite eingefügt.

Das eingefügte Diagramm ist mit dem Google Tabellen-Quelldiagramm verknüpft, aktualisiert. Andere Mitbearbeiter können den Link zur Quelltabelle sehen.

var sheet = SpreadsheetApp.openById('spreadsheetId').getSheets()[0];
var chart = sheet.getCharts()[0];
// Insert the spreadsheet chart in the first slide.
var slide = SlidesApp.getActivePresentation().getSlides()[0];
slide.insertSheetsChart(chart);

Parameter

Name	Typ	Beschreibung
`sourceChart`	`EmbeddedChart`	Das Diagramm in einer Tabellenkalkulation, das in die Seite eingefügt wird.

Rückflug

SheetsChart: Das Diagramm wurde auf der Seite eingefü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

`insertSheetsChart(sourceChart, left, top, width, height)`

Fügt ein Google Tabellen-Diagramm mit der angegebenen Position und Größe auf der Seite ein.

Damit das Seitenverhältnis des Diagramms erhalten bleibt, wird es entsprechend skaliert und zentriert in die angegebene Größe ein.

Das eingefügte Diagramm ist mit dem Google Tabellen-Quelldiagramm verknüpft, aktualisiert. Andere Mitbearbeiter können den Link zur Quelltabelle sehen.

var sheet = SpreadsheetApp.openById('spreadsheetId').getSheets()[0];
var chart = sheet.getCharts()[0];
// Insert the spreadsheet chart in the first slide.
var slide = SlidesApp.getActivePresentation().getSlides()[0];
var position = {left: 0, top: 0};
var size = {width: 200, height: 200};

// Also available for Layout, Master, and Page.
slide.insertSheetsChart(
    chart,
    position.left,
    position.top,
    size.width,
    size.height);

Parameter

Name	Typ	Beschreibung
`sourceChart`	`EmbeddedChart`	Das Diagramm in einer Tabellenkalkulation, das in die Seite eingefügt wird.
`left`	`Number`	Die horizontale Position des Diagramms in Punkten, gemessen von der oberen linken Ecke aus der Seite.
`top`	`Number`	Die vertikale Position des Diagramms in Punkten, gemessen von der oberen linken Ecke der auf der Seite.
`width`	`Number`	Die Breite des Diagramms in Punkten.
`height`	`Number`	Die Höhe des Diagramms in Punkten.

Rückflug

SheetsChart: Das Diagramm wurde auf der Seite eingefü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

`insertSheetsChart(sheetsChart)`

Fügt eine Kopie des bereitgestellten SheetsChart auf der Seite ein.

Die Position des eingefügten Elements auf dieser Seite wird anhand der Methode Position auf der jeweiligen Seite.

// Copy a sheets chart between presentations.
var otherPresentationSlide = SlidesApp.openById('presentationId').getSlides()[0];
var currentPresentationSlide = SlidesApp.getActivePresentation().getSlides()[0];
var sheetsChart = otherPresentationSlide.getSheetsCharts[0];

// Also available for Layout, Master, and Page.
currentPresentationSlide.insertSheetsChart(sheetsChart);

Parameter

Name	Typ	Beschreibung
`sheetsChart`	`SheetsChart`	Das Tabellenblattdiagramm, das kopiert und eingefügt werden soll.

Rückflug

SheetsChart: Das eingefügte Tabellenblattdiagramm.

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

`insertSheetsChartAsImage(sourceChart)`

Fügt ein Google Tabellen-Diagramm als Image auf der Seite ein.

Das Bild des Diagramms wird in Standardgröße oben links auf der Seite eingefügt.

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

var sheet = SpreadsheetApp.openById('spreadsheetId').getSheets()[0];
var chart = sheet.getCharts()[0];
// Insert the spreadsheet chart in the first slide.
var slide = SlidesApp.getActivePresentation().getSlides()[0];
slide.insertSheetsChartAsImage(chart); // Also available for Layout, Master, and Page.

Parameter

Name	Typ	Beschreibung
`sourceChart`	`EmbeddedChart`	Das Diagramm in einer Tabellenkalkulation, das in die Seite eingefügt wird.

Rückflug

Image: Das eingefügte Bild des Diagramms auf 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

`insertSheetsChartAsImage(sourceChart, left, top, width, height)`

Fügt ein Google Tabellen-Diagramm als Image auf der Seite mit der angegebenen Position und Größe.

Um das Seitenverhältnis des Diagrammbilds beizubehalten, wird das Bild mit in Bezug auf die angegebene Größe.

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

var sheet = SpreadsheetApp.openById('spreadsheetId').getSheets()[0];
var chart = sheet.getCharts()[0];
// Insert the spreadsheet chart in the first slide.
var slide = SlidesApp.getActivePresentation().getSlides()[0];
var position = {left: 0, top: 0};
var size = {width: 200, height: 200};

// Also available for Layout, Master, and Page.
slide.insertSheetsChartAsImage(
    chart,
    position.left,
    position.right,
    size.width,
    size.height);

Parameter

Name	Typ	Beschreibung
`sourceChart`	`EmbeddedChart`	Das Diagramm in einer Tabellenkalkulation, das in die Seite eingefügt wird.
`left`	`Number`	Die horizontale Position des Diagramms in Punkten, gemessen von der oberen linken Ecke aus der Seite.
`top`	`Number`	Die vertikale Position des Diagramms in Punkten, gemessen von der oberen linken Ecke der auf der Seite.
`width`	`Number`	Die Breite des Diagramms in Punkten.
`height`	`Number`	Die Höhe des Diagramms in Punkten.

Rückflug

Image: Das eingefügte Bild des Diagramms auf 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

`insertTable(numRows, numColumns)`

Fügt auf der Seite eine Tabelle ein.

Die Tabelle ist auf der Seite zentriert und hat die Standardgröße sowie gleichmäßig verteilte Zeilen und Spalten.

Parameter

Name	Typ	Beschreibung
`numRows`	`Integer`	Die Anzahl der Zeilen in der Tabelle
`numColumns`	`Integer`	Die Anzahl der Spalten in der Tabelle.

Rückflug

Table: Die eingefügte Tabelle.

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

`insertTable(numRows, numColumns, left, top, width, height)`

Fügt eine Tabelle mit der angegebenen Position und Größe auf der Seite ein.

Zeilen und Spalten sind in der erstellten Tabelle gleichmäßig verteilt.

Parameter

Name	Typ	Beschreibung
`numRows`	`Integer`	Die Anzahl der Zeilen in der Tabelle
`numColumns`	`Integer`	Die Anzahl der Spalten in der Tabelle.
`left`	`Number`	Die horizontale Position der Tabelle, gemessen von der oberen linken Ecke der Seite.
`top`	`Number`	Die vertikale Position der Tabelle, gemessen von der oberen linken Ecke der Seite.
`width`	`Number`	Breite der Tabelle.
`height`	`Number`	Die Mindesthöhe der Tabelle. Die tatsächliche Höhe der gerenderten Tabelle von Faktoren wie der Schriftgröße zu berücksichtigen.

Rückflug

Table: Die eingefügte Tabelle.

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

`insertTable(table)`

Fügt eine Kopie des bereitgestellten Table auf der Seite ein.

Die Position des eingefügten Elements auf dieser Seite wird anhand der Methode Position auf der jeweiligen Seite.

// Copy a table between presentations.
var otherPresentationSlide = SlidesApp.openById('presentationId').getSlides()[0];
var currentPresentationSlide = SlidesApp.getActivePresentation().getSlides()[0];
var table = otherPresentationSlide.getTables[0];
currentPresentationSlide.insertTable(table); // Also available for Layout, Master, and Page.

Parameter

Name	Typ	Beschreibung
`table`	`Table`	Die Tabelle, die kopiert und eingefügt werden soll.

Rückflug

Table: Die eingefügte Tabelle.

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

`insertTextBox(text)`

Fügt das Textfeld Shape ein, das den angegebenen String auf der Seite enthält.

Die Textfeldform wird mit einer Standardgröße oben links auf der Seite eingefügt.

// Insert text box with "Hello" on the first slide of presentation.
var slide = SlidesApp.getActivePresentation().getSlides()[0];
slide.insertTextBox('Hello'); // Also available for Layout, Master, and Page.

Parameter

Name	Typ	Beschreibung
`text`	`String`	Die Zeichenfolge, die die Form des Textfelds enthalten soll.

Rückflug

Shape: Die eingefügte Form des Textfelds.

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

`insertTextBox(text, left, top, width, height)`

Fügt das Textfeld Shape ein, das den angegebenen String auf der Seite enthält.

// Insert text box with "Hello" on the first slide of presentation. This text box is a square
// with a length of 10 points on each side.
var slide = SlidesApp.getActivePresentation().getSlides()[0];
slide.insertTextBox('Hello', 0, 0, 10, 10); // Also available for Layout, Master, and Page.

Parameter

Name	Typ	Beschreibung
`text`	`String`	Die Zeichenfolge, die die Form des Textfelds enthalten soll.
`left`	`Number`	Die horizontale Position der Textfeldform, gemessen von der oberen linken Ecke aus der Seite.
`top`	`Number`	Die vertikale Position des Textfeldes, gemessen von der oberen linken Ecke des auf der Seite.
`width`	`Number`	Die Breite der Textfeldform.
`height`	`Number`	Höhe der Textfeldform.

Rückflug

Shape: Die eingefügte Form des Textfelds.

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

`insertVideo(videoUrl)`

Fügt oben links auf der Seite ein Video in Standardgröße ein.

Derzeit werden nur YouTube-Videos unterstützt.

Parameter

Name	Typ	Beschreibung
`videoUrl`	`String`	Die URL des einzufügenden Videos.

Rückflug

Video: Das eingefügte Video.

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

`insertVideo(videoUrl, left, top, width, height)`

Fügt ein Video mit der angegebenen Position und Größe auf der Seite ein.

Derzeit werden nur YouTube-Videos unterstützt.

Parameter

Name	Typ	Beschreibung
`videoUrl`	`String`	Die URL des einzufügenden Videos.
`left`	`Number`	Die horizontale Position des Videos in Punkten, gemessen von der oberen linken Ecke der Seite.
`top`	`Number`	Die vertikale Position des Videos in Punkten, gemessen von der oberen linken Ecke des auf der Seite.
`width`	`Number`	Die Breite des Videos in Punkten.
`height`	`Number`	Die Höhe des Videos in Punkten.

Rückflug

Video: Das eingefügte Video.

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

`insertVideo(video)`

Fügt eine Kopie des bereitgestellten Video auf der Seite ein.

Die Position des eingefügten Elements auf dieser Seite wird anhand der Methode Position auf der jeweiligen Seite.

// Copy a video between presentations.
var otherPresentationSlide = SlidesApp.openById('presentationId').getSlides()[0];
var currentPresentationSlide = SlidesApp.getActivePresentation().getSlides()[0];
var video = otherPresentationSlide.getVideos[0];
currentPresentationSlide.insertVideo(video); // Also available for Layout, Master, and Page.

Parameter

Name	Typ	Beschreibung
`video`	`Video`	Das Video, das kopiert und eingefügt werden soll.

Rückflug

Video: Das eingefügte Video.

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

`insertWordArt(wordArt)`

Fügt eine Kopie des bereitgestellten WordArt auf der Seite ein.

Die Position des eingefügten Elements auf dieser Seite wird anhand der Methode Position auf der jeweiligen Seite.

// Copy a word art between presentations.
var otherPresentationSlide = SlidesApp.openById('presentationId').getSlides()[0];
var currentPresentationSlide = SlidesApp.getActivePresentation().getSlides()[0];
var wordArt = otherPresentationSlide.getWordArts[0];

// Also available for Layout, Master, and Page.
currentPresentationSlide.insertWordArt(wordArt);

Parameter

Name	Typ	Beschreibung
`wordArt`	`WordArt`	Die Gruppe, die kopiert und eingefügt werden soll.

Rückflug

WordArt: Das eingefügte WordArt-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

`remove()`

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

`replaceAllText(findText, replaceText)`

Ersetzt alle Vorkommen von Text, der mit "Text suchen" übereinstimmt, durch "Text ersetzen". Bei der Suche handelt es sich um die Groß-/Kleinschreibung. unsensibel.

Parameter

Name	Typ	Beschreibung
`findText`	`String`	Der zu suchende Text.
`replaceText`	`String`	Der Text, durch den der übereinstimmende Text ersetzt werden soll.

Rückflug

Integer: Anzahl der geänderten Vorkommen

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

`replaceAllText(findText, replaceText, matchCase)`

Ersetzt alle Vorkommen von Text, der mit "Text suchen" übereinstimmt, durch "Text ersetzen".

Parameter

Name	Typ	Beschreibung
`findText`	`String`	Der zu suchende Text.
`replaceText`	`String`	Der Text, durch den der übereinstimmende Text ersetzt werden soll.
`matchCase`	`Boolean`	Wenn `true`, wird bei der Suche zwischen Groß- und Kleinschreibung unterschieden. Wenn `false`, lautet die Suche Groß- und Kleinschreibung nicht berücksichtigt werden.

Rückflug

Integer: Anzahl der geänderten Vorkommen

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

`selectAsCurrentPage()`

Wählt das Page in der aktiven Präsentation als current page selection aus und entfernt die vorherige Auswahl.

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

// Select the first slide as the current page selection and replace any previous selection.
var slide = SlidesApp.getActivePresentation().getSlides()[0];
slide.selectAsCurrentPage(); // Also available for Layout, Master, and Page.

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