Ein Layout in einer Präsentation.
Jedes Layout dient als Vorlage für Folien, die davon abgeleitet werden, und bestimmt, wie die Inhalte auf diesen Folien angeordnet und formatiert werden.
Methoden
Methode | Rückgabetyp | Kurzbeschreibung |
---|---|---|
get | Page | Der Hintergrund der Seite wird abgerufen. |
get | Color | Ruft die Color ab, die der Seite zugeordnet ist. |
get | Group[] | Gibt die Liste der Group -Objekte auf der Seite zurück. |
get | Image[] | Gibt die Liste der Image -Objekte auf der Seite zurück. |
get | String | Ruft den Namen des Layouts ab. |
get | Line[] | Gibt die Liste der Line -Objekte auf der Seite zurück. |
get | Master | Ruft den Master ab, auf dem das Layout basiert. |
get | String | Die eindeutige ID der Seite wird abgerufen. |
get | Page | Gibt die Page auf der Seite mit der angegebenen ID zurück oder null , wenn keine vorhanden ist. |
get | Page | Gibt die Liste der Page -Objekte zurück, die auf der Seite gerendert werden. |
get | Page | Ruft den Typ der Seite ab. |
get | Page | Gibt das Platzhalter-Page -Objekt für ein bestimmtes Placeholder oder null zurück, wenn kein passender Platzhalter vorhanden ist. |
get | Page | Gibt das Platzhalter-Page -Objekt für eine angegebene Placeholder und einen Platzhalterindex zurück oder null , wenn der Platzhalter nicht vorhanden ist. |
get | Page | Gibt die Liste der Platzhalter-Page -Objekte auf der Seite zurück. |
get | Shape[] | Gibt die Liste der Shape -Objekte auf der Seite zurück. |
get | Sheets | Gibt die Liste der Sheets -Objekte auf der Seite zurück. |
get | Table[] | Gibt die Liste der Table -Objekte auf der Seite zurück. |
get | Video[] | Gibt die Liste der Video -Objekte auf der Seite zurück. |
get | Word | Gibt die Liste der Word -Objekte auf der Seite zurück. |
group(pageElements) | Group | Hiermit werden alle angegebenen Seitenelemente gruppiert. |
insert | Group | Fügt eine Kopie des angegebenen Group auf der Seite ein. |
insert | Image | Ein Bild wird links oben auf der Seite mit der Standardgröße aus dem angegebenen Bild-Blob eingefügt. |
insert | Image | Fügt ein Bild aus dem angegebenen Bild-Blob auf der Seite an der angegebenen Position und Größe ein. |
insert | Image | Fügt eine Kopie des angegebenen Image auf der Seite ein. |
insert | Image | Ein Bild wird oben links auf der Seite in der Standardgröße aus der angegebenen URL eingefügt. |
insert | Image | Ein Bild wird an der angegebenen Position und Größe von der angegebenen URL auf der Seite eingefügt. |
insert | Line | Fügt eine Kopie des angegebenen Line auf der Seite ein. |
insert | Line | Fügt eine Linie auf der Seite ein, die zwei connection sites verbindet. |
insert | Line | Fügt eine Linie auf der Seite ein. |
insert | Page | Fügt eine Kopie des angegebenen Page auf der Seite ein. |
insert | Shape | Fügt eine Kopie des angegebenen Shape auf der Seite ein. |
insert | Shape | Hiermit wird eine Form auf der Seite eingefügt. |
insert | Shape | Hiermit wird eine Form auf der Seite eingefügt. |
insert | Sheets | Ein Google Sheets-Diagramm wird auf der Seite eingefügt. |
insert | Sheets | Ein Google Tabellen-Diagramm wird an der angegebenen Position und mit der angegebenen Größe auf der Seite eingefügt. |
insert | Sheets | Fügt eine Kopie des angegebenen Sheets auf der Seite ein. |
insert | Image | Ein Google Tabellen-Diagramm wird als Image auf der Seite eingefügt. |
insert | Image | Ein Google Tabellen-Diagramm wird als Image an der angegebenen Position und Größe auf der Seite eingefügt. |
insert | Table | Damit wird eine Tabelle auf der Seite eingefügt. |
insert | Table | Fügt eine Tabelle mit der angegebenen Position und Größe auf der Seite ein. |
insert | Table | Fügt eine Kopie des angegebenen Table auf der Seite ein. |
insert | Shape | Ein Textfeld Shape mit dem angegebenen String wird auf der Seite eingefügt. |
insert | Shape | Ein Textfeld Shape mit dem angegebenen String wird auf der Seite eingefügt. |
insert | Video | Ein Video wird links oben auf der Seite in der Standardgröße eingefügt. |
insert | Video | Ein Video wird an der angegebenen Position und Größe auf der Seite eingefügt. |
insert | Video | Fügt eine Kopie des angegebenen Video auf der Seite ein. |
insert | Word | Fügt eine Kopie des angegebenen Word auf der Seite ein. |
remove() | void | Die Seite wird entfernt. |
replace | Integer | Ersetzt alle Textstellen, die mit dem Suchtext übereinstimmen, durch den Ersatztext. |
replace | Integer | Ersetzt alle Textstellen, die mit dem Suchtext übereinstimmen, durch den Ersatztext. |
select | void | Wählt die Page in der aktiven Präsentation als current page selection aus und entfernt alle vorherigen Auswahlen. |
Detaillierte Dokumentation
get Background()
Der Hintergrund der Seite.
Rückflug
Page
: Der Hintergrund der Seite.
Autorisierung
Scripts, 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
get Color Scheme()
Ruft die Color
ab, die der Seite zugeordnet ist.
Rückflug
Color
: Das Farbschema der Seite.
Autorisierung
Scripts, 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
get Groups()
get Images()
get Layout Name()
Ruft den Namen des Layouts ab.
Rückflug
String
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
get Lines()
get Master()
get Object Id()
Die eindeutige ID der Seite wird abgerufen. Die Objekt-IDs, die von Seiten und Seitenelementen verwendet werden, haben denselben Namespace.
Rückflug
String
Autorisierung
Scripts, 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
get Page Element By Id(id)
Gibt die Page
auf der Seite mit der angegebenen ID zurück oder null
, wenn keine vorhanden ist.
Parameter
Name | Typ | Beschreibung |
---|---|---|
id | String | Die ID des Seitenelements, das abgerufen wird. |
Rückflug
Page
: Das Seitenelement mit der angegebenen ID.
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
get Page Elements()
Gibt die Liste der Page
-Objekte zurück, die auf der Seite gerendert werden.
Rückflug
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
get Page Type()
get Placeholder(placeholderType)
Gibt das Platzhalter-Page
-Objekt für ein bestimmtes Placeholder
oder null
zurück, wenn kein passender Platzhalter vorhanden ist.
Wenn es mehrere Platzhalter mit demselben Typ gibt, wird derjenige mit dem minimalen Platzhalterindex zurückgegeben. Wenn es mehrere übereinstimmende Platzhalter mit demselben Index gibt, wird der erste Platzhalter aus der Sammlung der Seitenelemente der Seite zurückgegeben.
const slide = SlidesApp.getActivePresentation().getSlides()[0]; const placeholder = slide.getPlaceholder( SlidesApp.PlaceholderType.CENTERED_TITLE, );
Parameter
Name | Typ | Beschreibung |
---|---|---|
placeholder | Placeholder |
Rückflug
Autorisierung
Scripts, 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
get Placeholder(placeholderType, placeholderIndex)
Gibt das Platzhalter-Page
-Objekt für eine angegebene Placeholder
und einen Platzhalterindex zurück oder null
, wenn der Platzhalter nicht vorhanden ist.
Wenn es mehrere Platzhalter mit demselben Typ und Index gibt, wird der erste Platzhalter aus der Sammlung der Seitenelemente der Seite zurückgegeben.
const slide = SlidesApp.getActivePresentation().getSlides()[0]; const placeholder = slide.getPlaceholder( SlidesApp.PlaceholderType.CENTERED_TITLE, 0, );
Parameter
Name | Typ | Beschreibung |
---|---|---|
placeholder | Placeholder | |
placeholder | Integer |
Rückflug
Autorisierung
Scripts, 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
get Placeholders()
Gibt die Liste der Platzhalter-Page
-Objekte auf der Seite zurück.
const master = SlidesApp.getActivePresentation().getMasters()[0]; Logger.log( `Number of placeholders in the master: ${master.getPlaceholders().length}`, );
Rückflug
Autorisierung
Scripts, 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
get Shapes()
get Sheets Charts()
Gibt die Liste der Sheets
-Objekte auf der Seite zurück.
Rückflug
Autorisierung
Scripts, 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
get Tables()
get Videos()
get Word Arts()
group(pageElements)
Hiermit werden alle angegebenen Seitenelemente gruppiert.
Auf derselben Seite sollten mindestens zwei Seitenelemente vorhanden sein, die sich nicht bereits in einer anderen Gruppe befinden. Einige Seitenelemente wie Videos
, Tables
und placeholder Shapes
können nicht gruppiert werden.
Parameter
Name | Typ | Beschreibung |
---|---|---|
page | Page | Die Elemente, die gruppiert werden sollen. |
Rückflug
Group
– die neue Gruppe.
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
insert Group(group)
Fügt eine Kopie des angegebenen Group
auf der Seite ein.
Die Position des eingefügten Elements auf dieser Seite wird anhand der Position des Quellelements auf der jeweiligen Seite bestimmt.
Wenn das bereitgestellte Element ein Platzhalter ist, der aus der aktuellen Präsentation kopiert wird, werden Eigenschaften, die von Master- oder Layoutseiten übernommen werden, auch auf das eingefügte Element angewendet.
Wenn das bereitgestellte Element ein Platzhalter ist, der aus einer anderen Präsentation kopiert wird, werden Eigenschaften, die von Master- oder Layoutseiten übernommen werden, aus der Quellpräsentation in das Element kopiert.
// Copy a group between presentations. const otherPresentationSlide = SlidesApp.openById('presentationId').getSlides()[0]; const currentPresentationSlide = SlidesApp.getActivePresentation().getSlides()[0]; const 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
: Eingefügte Gruppe.
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
insert Image(blobSource)
Ein Bild wird links oben auf der Seite mit der Standardgröße aus dem angegebenen Bild-Blob eingefügt.
Wenn Sie das Bild einfügen, wird es einmal aus der Blob
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 slide = SlidesApp.getActivePresentation().getSlides()[0]; // Get the Drive image file with the given ID. const image = DriveApp.getFileById('123abc'); slide.insertImage(image);
Parameter
Name | Typ | Beschreibung |
---|---|---|
blob | Blob | Die Bilddaten. |
Rückflug
Image
– das eingefügte Bild.
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
insert Image(blobSource, left, top, width, height)
Fügt ein Bild aus dem angegebenen Bild-Blob auf der Seite an der angegebenen Position und Größe ein.
Das Bild wird beim Einfügen einmal von der angegebenen Blob
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.
Um das Seitenverhältnis des Bildes beizubehalten, wird es skaliert und anhand der angegebenen Größe zentriert.
const slide = SlidesApp.getActivePresentation().getSlides()[0]; // Get the Drive image file with the given ID. const image = DriveApp.getFileById('123abc'); const position = { left: 0, top: 0 }; const size = { width: 300, height: 100 }; slide.insertImage(image, position.left, position.top, size.width, size.height);
Parameter
Name | Typ | Beschreibung |
---|---|---|
blob | Blob | Die Bilddaten. |
left | Number | Die horizontale Position des Bildes in Punkten, gemessen von der linken oberen Ecke der Seite. |
top | Number | Die vertikale Position des Bildes in Punkten, gemessen von der linken oberen Ecke 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
Scripts, 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
insert Image(image)
Fügt eine Kopie des angegebenen Image
auf der Seite ein.
Die Position der eingefügten Bilder auf dieser Seite wird anhand der Position des Quellbilds auf der jeweiligen Seite bestimmt.
Wenn das bereitgestellte Bild ein Platzhalter ist, der aus der aktuellen Präsentation kopiert wird, werden Eigenschaften, die von Master- oder Layoutseiten übernommen werden, auch auf das eingefügte Bild angewendet.
Wenn das bereitgestellte Bild ein Platzhalter ist, der aus einer anderen Präsentation kopiert wird, werden Eigenschaften, die von Master- oder Layoutseiten übernommen werden, aus der Quellpräsentation in das Bild kopiert. Wenn das kopierte Platzhalterbild leer ist, wird in der Zielpräsentation nichts eingefügt.
// Copy an image between presentations. const otherPresentationSlide = SlidesApp.openById('presentationId').getSlides()[0]; const currentPresentationSlide = SlidesApp.getActivePresentation().getSlides()[0]; const 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
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
insert Image(imageUrl)
Ein Bild wird oben links auf der Seite in der Standardgröße aus der angegebenen URL eingefügt.
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.
Parameter
Name | Typ | Beschreibung |
---|---|---|
image | String | Die Bild-URL. |
Rückflug
Image
– das eingefügte Bild.
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
insert Image(imageUrl, left, top, width, height)
Ein Bild wird an der angegebenen Position und Größe von der angegebenen URL auf der Seite eingefügt.
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 angegebenen Größe zentriert.
Parameter
Name | Typ | Beschreibung |
---|---|---|
image | String | Die Bild-URL. |
left | Number | Die horizontale Position des Bildes in Punkten, gemessen von der linken oberen Ecke der Seite. |
top | Number | Die vertikale Position des Bildes in Punkten, gemessen von der linken oberen Ecke 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
Scripts, 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
insert Line(line)
Fügt eine Kopie des angegebenen Line
auf der Seite ein.
Die Position des eingefügten Elements auf dieser Seite wird anhand der Position des Quellelements auf der jeweiligen Seite bestimmt.
Wenn das bereitgestellte Element ein Platzhalter ist, der aus der aktuellen Präsentation kopiert wird, werden Eigenschaften, die von Master- oder Layoutseiten übernommen werden, auch auf das eingefügte Element angewendet.
Wenn das bereitgestellte Element ein Platzhalter ist, der aus einer anderen Präsentation kopiert wird, werden Eigenschaften, die von Master- oder Layoutseiten übernommen werden, aus der Quellpräsentation in das Element kopiert.
// Copy a line between presentations. const otherPresentationSlide = SlidesApp.openById('presentationId').getSlides()[0]; const currentPresentationSlide = SlidesApp.getActivePresentation().getSlides()[0]; const line = otherPresentationSlide.getLines[0]; currentPresentationSlide.insertLine(line);
Parameter
Name | Typ | Beschreibung |
---|---|---|
line | Line | Die Zeile, die kopiert und eingefügt werden soll. |
Rückflug
Line
: Die eingefügte Zeile.
Autorisierung
Scripts, 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
insert Line(lineCategory, startConnectionSite, endConnectionSite)
Fügt eine Linie auf der Seite ein, die zwei connection sites
verbindet. Die beiden Verbindungsstellen müssen sich auf dieser Seite befinden.
// Insert a line in the first slide of the presentation connecting two shapes. const slide = SlidesApp.getActivePresentation().getSlides()[0]; const shape1 = slide.insertShape(SlidesApp.ShapeType.RECTANGLE); const shape2 = slide.insertShape(SlidesApp.ShapeType.CLOUD); slide.insertLine( SlidesApp.LineCategory.BENT, shape1.getConnectionSites()[0], shape2.getConnectionSites()[1], );
Parameter
Name | Typ | Beschreibung |
---|---|---|
line | Line | Die Kategorie der einzufügenden Zeile. |
start | Connection | Die Verbindungsstelle, an der der Anfang der Linie verbunden werden soll. |
end | Connection | Die Verbindungsstelle, an der das Ende der Leitung angeschlossen werden soll. |
Rückflug
Line
: Die eingefügte Zeile.
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
insert Line(lineCategory, startLeft, startTop, endLeft, endTop)
Fügt eine Linie auf der Seite ein.
// Insert a line in the first slide of the presentation. const slide = SlidesApp.getActivePresentation().getSlides()[0]; const startPoint = { left: 10, top: 10 }; const endPoint = { left: 40, top: 40 }; slide.insertLine( SlidesApp.LineCategory.STRAIGHT, startPoint.left, startPoint.top, endPoint.left, endPoint.top, );
Parameter
Name | Typ | Beschreibung |
---|---|---|
line | Line | Die Kategorie der einzufügenden Zeile. |
start | Number | Die horizontale Position des Startpunkts der Linie, gemessen in Punkten vom linken oberen Eckpunkt der Seite aus. |
start | Number | Die vertikale Position des Startpunkts der Linie, gemessen in Punkten von der linken oberen Ecke der Seite aus. |
end | Number | Die horizontale Position des Endpunkts der Linie, gemessen in Punkten vom linken oberen Eckpunkt der Seite aus. |
end | Number | Die vertikale Position des Endpunkts der Linie, gemessen in Punkten vom linken oberen Eckpunkt der Seite aus. |
Rückflug
Line
: Die eingefügte Zeile.
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
insert Page Element(pageElement)
Fügt eine Kopie des angegebenen Page
auf der Seite ein.
Die Position des eingefügten Elements auf dieser Seite wird anhand der Position des Quellelements auf der jeweiligen Seite bestimmt.
Wenn das bereitgestellte Element ein Platzhalter ist, der aus der aktuellen Präsentation kopiert wird, werden Eigenschaften, die von Master- oder Layoutseiten übernommen werden, auch auf das eingefügte Element angewendet.
Wenn das bereitgestellte Element ein Platzhalter ist, der aus einer anderen Präsentation kopiert wird, werden Eigenschaften, die von Master- oder Layoutseiten übernommen werden, aus der Quellpräsentation in das Element kopiert.
// Copy a page element between presentations. const otherPresentationSlide = SlidesApp.openById('presentationId').getSlides()[0]; const currentPresentationSlide = SlidesApp.getActivePresentation().getSlides()[0]; const pageElement = otherPresentationSlide.getPageElements()[0]; // Also available for Layout, Master, and Page. currentPresentationSlide.insertPageElement(pageElement);
Parameter
Name | Typ | Beschreibung |
---|---|---|
page | Page | Das Seitenelement, das kopiert und eingefügt werden soll. |
Rückflug
Page
: Das eingefügte 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
insert Shape(shape)
Fügt eine Kopie des angegebenen Shape
auf der Seite ein.
Die Position des eingefügten Elements auf dieser Seite wird anhand der Position des Quellelements auf der jeweiligen Seite bestimmt.
Wenn das bereitgestellte Element ein Platzhalter ist, der aus der aktuellen Präsentation kopiert wird, werden Eigenschaften, die von Master- oder Layoutseiten übernommen werden, auch auf das eingefügte Element angewendet.
Wenn das bereitgestellte Element ein Platzhalter ist, der aus einer anderen Präsentation kopiert wird, werden Eigenschaften, die von Master- oder Layoutseiten übernommen werden, aus der Quellpräsentation in das Element kopiert.
// Copy a shape between presentations. const otherPresentationSlide = SlidesApp.openById('presentationId').getSlides()[0]; const currentPresentationSlide = SlidesApp.getActivePresentation().getSlides()[0]; const 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
Scripts, 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
insert Shape(shapeType)
Hiermit wird eine Form auf der Seite eingefügt.
Die Form wird in der Standardgröße links oben auf der Seite eingefügt.
// Insert a shape in the first slide of the presentation. const slide = SlidesApp.getActivePresentation().getSlides()[0]; // Also available for Layout, Master, and Page. slide.insertShape(SlidesApp.ShapeType.RECTANGLE);
Parameter
Name | Typ | Beschreibung |
---|---|---|
shape | Shape | Die einzufügende Form. |
Rückflug
Shape
– Die eingefügte Form.
Autorisierung
Scripts, 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
insert Shape(shapeType, left, top, width, height)
Hiermit wird eine Form auf der Seite eingefügt.
Parameter
Name | Typ | Beschreibung |
---|---|---|
shape | Shape | Die einzufügende Form. |
left | Number | Die horizontale Position der Form, gemessen von der linken oberen Ecke der Seite. |
top | Number | Die vertikale Position der Form, gemessen von der linken oberen Ecke der Seite. |
width | Number | Die Breite der Form. |
height | Number | Die Höhe der Form. |
Rückflug
Shape
– Die eingefügte Form.
Autorisierung
Scripts, 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
insert Sheets Chart(sourceChart)
Ein Google Sheets-Diagramm wird auf der Seite eingefügt.
Das Diagramm wird in der Standardgröße links oben auf der Seite eingefügt.
Das eingefügte Diagramm ist mit dem Google Tabellen-Quelldiagramm verknüpft und kann daher aktualisiert werden. Andere Mitbearbeiter sehen den Link zur Quelltabelle.
const sheet = SpreadsheetApp.openById('spreadsheetId').getSheets()[0]; const chart = sheet.getCharts()[0]; // Insert the spreadsheet chart in the first slide. const slide = SlidesApp.getActivePresentation().getSlides()[0]; slide.insertSheetsChart(chart);
Parameter
Name | Typ | Beschreibung |
---|---|---|
source | Embedded | Das Diagramm in einer Tabelle, das in die Seite eingefügt werden soll. |
Rückflug
Sheets
: Das auf der Seite eingefügte Diagramm.
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
insert Sheets Chart(sourceChart, left, top, width, height)
Ein Google Tabellen-Diagramm wird an der angegebenen Position und mit der angegebenen Größe auf der Seite eingefügt.
Um das Seitenverhältnis des Diagramms beizubehalten, wird es anhand der angegebenen Größe skaliert und zentriert.
Das eingefügte Diagramm ist mit dem Google Tabellen-Quelldiagramm verknüpft und kann daher aktualisiert werden. Andere Mitbearbeiter sehen den Link zur Quelltabelle.
const sheet = SpreadsheetApp.openById('spreadsheetId').getSheets()[0]; const chart = sheet.getCharts()[0]; // Insert the spreadsheet chart in the first slide. const slide = SlidesApp.getActivePresentation().getSlides()[0]; const position = { left: 0, top: 0 }; const 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 |
---|---|---|
source | Embedded | Das Diagramm in einer Tabelle, das in die Seite eingefügt werden soll. |
left | Number | Die horizontale Position des Diagramms in Punkten, gemessen vom linken oberen Seitenrand. |
top | Number | Die vertikale Position des Diagramms in Punkten, gemessen vom linken oberen Seitenrand aus. |
width | Number | Die Breite des Diagramms in Punkten. |
height | Number | Die Höhe des Diagramms in Punkten. |
Rückflug
Sheets
: Das auf der Seite eingefügte Diagramm.
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
insert Sheets Chart(sheetsChart)
Fügt eine Kopie des angegebenen Sheets
auf der Seite ein.
Die Position des eingefügten Elements auf dieser Seite wird anhand der Position des Quellelements auf der jeweiligen Seite bestimmt.
Wenn das bereitgestellte Element ein Platzhalter ist, der aus der aktuellen Präsentation kopiert wird, werden Eigenschaften, die von Master- oder Layoutseiten übernommen werden, auch auf das eingefügte Element angewendet.
Wenn das bereitgestellte Element ein Platzhalter ist, der aus einer anderen Präsentation kopiert wird, werden Eigenschaften, die von Master- oder Layoutseiten übernommen werden, aus der Quellpräsentation in das Element kopiert.
// Copy a sheets chart between presentations. const otherPresentationSlide = SlidesApp.openById('presentationId').getSlides()[0]; const currentPresentationSlide = SlidesApp.getActivePresentation().getSlides()[0]; const sheetsChart = otherPresentationSlide.getSheetsCharts[0]; // Also available for Layout, Master, and Page. currentPresentationSlide.insertSheetsChart(sheetsChart);
Parameter
Name | Typ | Beschreibung |
---|---|---|
sheets | Sheets | Das Diagramm in Google Tabellen, das kopiert und eingefügt werden soll. |
Rückflug
Sheets
: Das eingefügte Diagramm aus Google Tabellen.
Autorisierung
Scripts, 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
insert Sheets Chart As Image(sourceChart)
Ein Google Tabellen-Diagramm wird als Image
auf der Seite eingefügt.
Das Bild des Diagramms wird in der Standardgröße links oben auf der Seite eingefügt.
Das eingefügte Diagrammbild ist nicht mit dem Quelldiagramm in Google Tabellen verknüpft.
const sheet = SpreadsheetApp.openById('spreadsheetId').getSheets()[0]; const chart = sheet.getCharts()[0]; // Insert the spreadsheet chart in the first slide. const slide = SlidesApp.getActivePresentation().getSlides()[0]; slide.insertSheetsChartAsImage( chart); // Also available for Layout, Master, and Page.
Parameter
Name | Typ | Beschreibung |
---|---|---|
source | Embedded | Das Diagramm in einer Tabelle, das in die Seite eingefügt werden soll. |
Rückflug
Image
: Das eingefügte Bild des Diagramms auf 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
insert Sheets Chart As Image(sourceChart, left, top, width, height)
Ein Google Tabellen-Diagramm wird als Image
an der angegebenen Position und Größe auf der Seite eingefügt.
Um das Seitenverhältnis des Diagrammbilds beizubehalten, wird es skaliert und anhand der angegebenen Größe zentriert.
Das eingefügte 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]; // Insert the spreadsheet chart in the first slide. const slide = SlidesApp.getActivePresentation().getSlides()[0]; const position = { left: 0, top: 0 }; const 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 |
---|---|---|
source | Embedded | Das Diagramm in einer Tabelle, das in die Seite eingefügt werden soll. |
left | Number | Die horizontale Position des Diagramms in Punkten, gemessen vom linken oberen Seitenrand. |
top | Number | Die vertikale Position des Diagramms in Punkten, gemessen vom linken oberen Seitenrand aus. |
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
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
insert Table(numRows, numColumns)
Damit wird eine Tabelle auf der Seite eingefügt.
Die Tabelle ist mit der Standardgröße und gleichmäßig verteilten Zeilen und Spalten auf der Seite zentriert.
Parameter
Name | Typ | Beschreibung |
---|---|---|
num | Integer | Die Anzahl der Zeilen in der Tabelle |
num | Integer | Die Anzahl der Spalten in der Tabelle. |
Rückflug
Table
: Die eingefügte Tabelle.
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
insert Table(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 |
---|---|---|
num | Integer | Die Anzahl der Zeilen in der Tabelle |
num | Integer | Die Anzahl der Spalten in der Tabelle. |
left | Number | Die horizontale Position der Tabelle, gemessen vom linken oberen Seitenrand. |
top | Number | Die vertikale Position der Tabelle, gemessen von der linken oberen Ecke der Seite. |
width | Number | Die Breite der Tabelle. |
height | Number | Die minimale Höhe der Tabelle. Die tatsächliche Höhe der gerenderten Tabelle hängt von Faktoren wie der Textschriftart ab. |
Rückflug
Table
: Die eingefügte Tabelle.
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
insert Table(table)
Fügt eine Kopie des angegebenen Table
auf der Seite ein.
Die Position des eingefügten Elements auf dieser Seite wird anhand der Position des Quellelements auf der jeweiligen Seite bestimmt.
Wenn das bereitgestellte Element ein Platzhalter ist, der aus der aktuellen Präsentation kopiert wird, werden Eigenschaften, die von Master- oder Layoutseiten übernommen werden, auch auf das eingefügte Element angewendet.
Wenn das bereitgestellte Element ein Platzhalter ist, der aus einer anderen Präsentation kopiert wird, werden Eigenschaften, die von Master- oder Layoutseiten übernommen werden, aus der Quellpräsentation in das Element kopiert.
// Copy a table between presentations. const otherPresentationSlide = SlidesApp.openById('presentationId').getSlides()[0]; const currentPresentationSlide = SlidesApp.getActivePresentation().getSlides()[0]; const 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
Scripts, 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
insert Text Box(text)
Ein Textfeld Shape
mit dem angegebenen String wird auf der Seite eingefügt.
Die Textfeldform wird in der Standardgröße oben links auf der Seite eingefügt.
// Insert text box with "Hello" on the first slide of presentation. const slide = SlidesApp.getActivePresentation().getSlides()[0]; slide.insertTextBox('Hello'); // Also available for Layout, Master, and Page.
Parameter
Name | Typ | Beschreibung |
---|---|---|
text | String | Der String, den die Textfeldform enthalten soll. |
Rückflug
Shape
: Die Form des eingefügten Textfelds.
Autorisierung
Scripts, 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
insert Text Box(text, left, top, width, height)
Ein Textfeld Shape
mit dem angegebenen String wird auf der Seite eingefügt.
// 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. const 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 | Der String, den die Textfeldform enthalten soll. |
left | Number | Die horizontale Position des Textfelds, gemessen von der linken oberen Ecke der Seite. |
top | Number | Die vertikale Position des Textfelds, gemessen von der linken oberen Ecke der Seite. |
width | Number | Die Breite des Textfelds. |
height | Number | Die Höhe des Textfelds. |
Rückflug
Shape
: Die Form des eingefügten Textfelds.
Autorisierung
Scripts, 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
insert Video(videoUrl)
Ein Video wird links oben auf der Seite in der Standardgröße eingefügt.
Derzeit werden nur YouTube-Videos unterstützt.
Parameter
Name | Typ | Beschreibung |
---|---|---|
video | String | Die URL des einzufügenden Videos. |
Rückflug
Video
– das eingefügte Video
Autorisierung
Scripts, 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
insert Video(videoUrl, left, top, width, height)
Ein Video wird an der angegebenen Position und Größe auf der Seite eingefügt.
Derzeit werden nur YouTube-Videos unterstützt.
Parameter
Name | Typ | Beschreibung |
---|---|---|
video | String | Die URL des einzufügenden Videos. |
left | Number | Die horizontale Position des Videos in Pixeln, gemessen von der linken oberen Ecke der Seite. |
top | Number | Die vertikale Position des Videos in Punkten, gemessen von der linken oberen Ecke 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
Scripts, 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
insert Video(video)
Fügt eine Kopie des angegebenen Video
auf der Seite ein.
Die Position des eingefügten Elements auf dieser Seite wird anhand der Position des Quellelements auf der jeweiligen Seite bestimmt.
Wenn das bereitgestellte Element ein Platzhalter ist, der aus der aktuellen Präsentation kopiert wird, werden Eigenschaften, die von Master- oder Layoutseiten übernommen werden, auch auf das eingefügte Element angewendet.
Wenn das bereitgestellte Element ein Platzhalter ist, der aus einer anderen Präsentation kopiert wird, werden Eigenschaften, die von Master- oder Layoutseiten übernommen werden, aus der Quellpräsentation in das Element kopiert.
// Copy a video between presentations. const otherPresentationSlide = SlidesApp.openById('presentationId').getSlides()[0]; const currentPresentationSlide = SlidesApp.getActivePresentation().getSlides()[0]; const 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
Scripts, 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
insert Word Art(wordArt)
Fügt eine Kopie des angegebenen Word
auf der Seite ein.
Die Position des eingefügten Elements auf dieser Seite wird anhand der Position des Quellelements auf der jeweiligen Seite bestimmt.
Wenn das bereitgestellte Element ein Platzhalter ist, der aus der aktuellen Präsentation kopiert wird, werden Eigenschaften, die von Master- oder Layoutseiten übernommen werden, auch auf das eingefügte Element angewendet.
Wenn das bereitgestellte Element ein Platzhalter ist, der aus einer anderen Präsentation kopiert wird, werden Eigenschaften, die von Master- oder Layoutseiten übernommen werden, aus der Quellpräsentation in das Element kopiert.
// Copy a word art between presentations. const otherPresentationSlide = SlidesApp.openById('presentationId').getSlides()[0]; const currentPresentationSlide = SlidesApp.getActivePresentation().getSlides()[0]; const wordArt = otherPresentationSlide.getWordArts[0]; // Also available for Layout, Master, and Page. currentPresentationSlide.insertWordArt(wordArt);
Parameter
Name | Typ | Beschreibung |
---|---|---|
word | Word | Die Gruppe, die kopiert und eingefügt werden soll. |
Rückflug
Word
: Das eingefügte WordArt-Objekt.
Autorisierung
Scripts, 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()
Die Seite wird entfernt.
Autorisierung
Scripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
replace All Text(findText, replaceText)
Ersetzt alle Textstellen, die mit dem Suchtext übereinstimmen, durch den Ersatztext. Bei der Suche wird nicht zwischen Groß- und Kleinschreibung unterschieden.
Parameter
Name | Typ | Beschreibung |
---|---|---|
find | String | Der zu suchende Text. |
replace | String | Der Text, durch den der übereinstimmende Text ersetzt werden soll. |
Rückflug
Integer
– die Anzahl der Wiederholungen hat sich geändert
Autorisierung
Scripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
replace All Text(findText, replaceText, matchCase)
Ersetzt alle Textstellen, die mit dem Suchtext übereinstimmen, durch den Ersatztext.
Parameter
Name | Typ | Beschreibung |
---|---|---|
find | String | Der zu suchende Text. |
replace | String | Der Text, durch den der übereinstimmende Text ersetzt werden soll. |
match | Boolean | Bei true wird bei der Suche zwischen Groß- und Kleinschreibung unterschieden. Bei false wird die Groß- und Kleinschreibung nicht berücksichtigt. |
Rückflug
Integer
– die Anzahl der Wiederholungen hat sich geändert
Autorisierung
Scripts, 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 As Current Page()
Wählt die Page
in der aktiven Präsentation als current page selection
aus und entfernt alle vorherigen Auswahlen.
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.
// Select the first slide as the current page selection and replace any previous // selection. const slide = SlidesApp.getActivePresentation().getSlides()[0]; slide.selectAsCurrentPage(); // Also available for Layout, Master, and Page.
Autorisierung
Scripts, 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