Eine PageElement
, die eine Linie darstellt.
Methoden
Methode | Rückgabetyp | Kurzbeschreibung |
---|---|---|
alignOnPage(alignmentPosition) | Line | Das Element wird an der angegebenen Ausrichtungsposition auf der Seite ausgerichtet. |
bringForward() | Line | Verschiebt das Seitenelement auf der Seite um ein Element nach vorne. |
bringToFront() | Line | Das Seitenelement wird an den Anfang der Seite verschoben. |
duplicate() | PageElement | Das Seitenelement wird dupliziert. |
getConnectionSites() | ConnectionSite[] | Gibt die Liste der ConnectionSite s im Seitenelement zurück oder eine leere Liste, wenn das Seitenelement keine Verbindungsstellen hat. |
getDashStyle() | DashStyle | Ruft den DashStyle der Zeile ab. |
getDescription() | String | Gibt die Alt-Text-Beschreibung des Seitenelements zurück. |
getEnd() | Point | Gibt den Endpunkt der Linie zurück, gemessen von der oberen linken Ecke der Seite. |
getEndArrow() | ArrowStyle | Ruft die ArrowStyle des Pfeils am Ende der Zeile ab. |
getEndConnection() | ConnectionSite | Gibt die Verbindung am Ende der Linie zurück oder null , wenn keine Verbindung vorhanden ist. |
getHeight() | Number | Die Höhe des Elements in Punkten. Das ist die Höhe des Begrenzungsrahmens des Elements, wenn es nicht gedreht ist. |
getInherentHeight() | Number | Gibt die Höhe des Elements in Punkten zurück. |
getInherentWidth() | Number | Gibt die Breite des Elements in Punkten zurück. |
getLeft() | Number | Gibt die horizontale Position des Elements in Punkten zurück, gemessen von der linken oberen Ecke der Seite, wenn das Element nicht gedreht ist. |
getLineCategory() | LineCategory | Ruft den LineCategory der Zeile ab. |
getLineFill() | LineFill | Ruft den LineFill der Zeile ab. |
getLineType() | LineType | Ruft den LineType der Zeile ab. |
getLink() | Link | Gibt Link oder null zurück, wenn kein Link vorhanden ist. |
getObjectId() | String | Die eindeutige ID für dieses Objekt. |
getPageElementType() | PageElementType | Gibt den Typ des Seitenelements als PageElementType -Enum zurück. |
getParentGroup() | Group | Gibt die Gruppe zurück, zu der dieses Seitenelement gehört, oder null , wenn das Element keiner Gruppe zugewiesen ist. |
getParentPage() | Page | Gibt die Seite zurück, auf der sich dieses Seitenelement befindet. |
getRotation() | Number | Gibt den Drehwinkel des Elements im Uhrzeigersinn um seine Mitte in Grad zurück. Null Grad bedeutet, dass das Element nicht gedreht wird. |
getStart() | Point | Gibt den Startpunkt der Linie zurück, gemessen vom linken oberen Eckpunkt der Seite. |
getStartArrow() | ArrowStyle | Ruft das ArrowStyle des Pfeils am Anfang der Zeile ab. |
getStartConnection() | ConnectionSite | Gibt die Verbindung am Anfang der Linie zurück oder null , wenn keine Verbindung vorhanden ist. |
getTitle() | String | Gibt den Titel des Alt-Texts des Seitenelements zurück. |
getTop() | Number | Die vertikale Position des Elements in Punkten, gemessen von der oberen linken Ecke der Seite, wenn das Element nicht gedreht ist. |
getTransform() | AffineTransform | Gibt die Transformation des Seitenelements zurück. |
getWeight() | Number | Gibt die Linienstärke in Punkten zurück. |
getWidth() | Number | Gibt die Breite des Elements in Punkten zurück. Das ist die Breite des Begrenzungsrahmens des Elements, wenn es nicht gedreht ist. |
isConnector() | Boolean | Gibt true zurück, wenn die Linie ein Verbindungselement ist, andernfalls false . |
preconcatenateTransform(transform) | Line | Die angegebene Transformation wird mit der vorhandenen Transformation des Seitenelements vorkonkateniert. |
remove() | void | Entfernt das Seitenelement. |
removeLink() | void | Entfernt einen Link . |
reroute() | Line | Start- und Endpunkt der Linie werden zu den beiden am nächsten gelegenen Verbindungsstellen auf den verbundenen Seitenelementen umgeleitet. |
scaleHeight(ratio) | Line | Die Höhe des Elements wird mit dem angegebenen Verhältnis skaliert. |
scaleWidth(ratio) | Line | Die Breite des Elements wird mit dem angegebenen Verhältnis skaliert. |
select() | void | Wählt nur die PageElement in der aktiven Präsentation aus und entfernt alle vorherigen Auswahlen. |
select(replace) | void | Wählt das PageElement in der aktiven Präsentation aus. |
sendBackward() | Line | Versetzt das Seitenelement auf der Seite um ein Element zurück. |
sendToBack() | Line | Versetzt das Seitenelement ans Ende der Seite. |
setDashStyle(style) | Line | Legt die DashStyle der Linie fest. |
setDescription(description) | Line | Hiermit wird die Alt-Text-Beschreibung des Seitenelements festgelegt. |
setEnd(left, top) | Line | Legt die Position des Endpunkts der Linie fest. |
setEnd(point) | Line | Legt die Position des Endpunkts der Linie fest. |
setEndArrow(style) | Line | Hiermit wird die ArrowStyle des Pfeils am Ende der Linie festgelegt. |
setEndConnection(connectionSite) | Line | Legt die Verbindung am Ende der Linie fest. |
setHeight(height) | Line | Hiermit wird die Höhe des Elements in Punkten festgelegt. Das ist die Höhe des Begrenzungsrahmens des Elements, wenn es nicht gedreht ist. |
setLeft(left) | Line | Legt die horizontale Position des Elements in Punkten fest, gemessen von der linken oberen Ecke der Seite, wenn das Element nicht gedreht ist. |
setLineCategory(lineCategory) | Line | Legt die LineCategory der Linie fest. |
setLinkSlide(slideIndex) | Link | Legt mit dem nullbasierten Index der Folie eine Link für die angegebene Slide fest. |
setLinkSlide(slide) | Link | Hier wird eine Link auf die angegebene Slide festgelegt. Der Link wird anhand der angegebenen Folien-ID festgelegt. |
setLinkSlide(slidePosition) | Link | Legt mithilfe der relativen Position der Folie einen Link für die angegebene Slide fest. |
setLinkUrl(url) | Link | Legt einen Link für den angegebenen nicht leeren URL-String fest. |
setRotation(angle) | Line | Legt den Drehwinkel des Elements im Uhrzeigersinn um seine Mitte in Grad fest. |
setStart(left, top) | Line | Legt die Position des Startpunkts der Linie fest. |
setStart(point) | Line | Legt die Position des Startpunkts der Linie fest. |
setStartArrow(style) | Line | Legt die ArrowStyle des Pfeils am Anfang der Zeile fest. |
setStartConnection(connectionSite) | Line | Legt die Verbindung am Anfang der Zeile fest. |
setTitle(title) | Line | Hiermit wird der Titel des Alt-Texts für das Seitenelement festgelegt. |
setTop(top) | Line | Legt die vertikale Position des Elements in Punkten fest, gemessen von der linken oberen Ecke der Seite, wenn das Element nicht gedreht ist. |
setTransform(transform) | Line | Legt die Transformation des Seitenelements mit der angegebenen Transformation fest. |
setWeight(points) | Line | Hier legen Sie die Linienstärke in Punkten fest. |
setWidth(width) | Line | Hiermit wird die Breite des Elements in Punkten festgelegt. Das ist die Breite des Begrenzungsrahmens des Elements, wenn es nicht gedreht ist. |
Detaillierte Dokumentation
alignOnPage(alignmentPosition)
Das Element wird an der angegebenen Ausrichtungsposition auf der Seite ausgerichtet.
Parameter
Name | Typ | Beschreibung |
---|---|---|
alignmentPosition | AlignmentPosition | Die Position, an der dieses Seitenelement auf der Seite ausgerichtet werden soll. |
Rückflug
Line
– dieses Seitenelement zur Verkettung
bringForward()
Verschiebt das Seitenelement auf der Seite um ein Element nach vorne.
Das Seitenelement darf sich nicht in einer Gruppe befinden.
Rückflug
Line
– dieses Seitenelement zur Verkettung
Autorisierung
Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
bringToFront()
Das Seitenelement wird an den Anfang der Seite verschoben.
Das Seitenelement darf sich nicht in einer Gruppe befinden.
Rückflug
Line
– dieses Seitenelement zur Verkettung
Autorisierung
Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
duplicate()
Das Seitenelement wird dupliziert.
Das duplizierte Seitenelement wird auf derselben Seite an derselben Position wie das Original platziert.
Rückflug
PageElement
: Das neue Duplikat dieses Seitenelements.
Autorisierung
Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getConnectionSites()
Gibt die Liste der ConnectionSite
s im Seitenelement zurück oder eine leere Liste, wenn das Seitenelement keine Verbindungsstellen hat.
Rückflug
ConnectionSite[]
: Liste der Verbindungsstellen. Diese Liste kann leer sein, wenn dieses Element keine Verbindungsstellen hat.
Autorisierung
Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getDashStyle()
Ruft den DashStyle
der Zeile ab.
Rückflug
DashStyle
: Der Stil der Strichsetzung für diese Linie.
Autorisierung
Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getDescription()
Gibt die Alt-Text-Beschreibung des Seitenelements zurück. Die Beschreibung wird mit dem Titel kombiniert, um den Alt-Text anzuzeigen und vorzulesen.
Rückflug
String
: Die Alt-Text-Beschreibung des Seitenelements.
Autorisierung
Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getEnd()
Gibt den Endpunkt der Linie zurück, gemessen von der oberen linken Ecke der Seite.
Rückflug
Point
: Der Endpunkt der Linie.
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
getEndArrow()
Ruft die ArrowStyle
des Pfeils am Ende der Zeile ab.
Rückflug
ArrowStyle
– Der Stil des Pfeils am Ende dieser Linie.
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
getEndConnection()
Gibt die Verbindung am Ende der Linie zurück oder null
, wenn keine Verbindung vorhanden ist.
Rückflug
ConnectionSite
– Die Verbindung am Ende der Linie.
Autorisierung
Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getHeight()
Die Höhe des Elements in Punkten. Das ist die Höhe des Begrenzungsrahmens des Elements, wenn es nicht gedreht ist.
Diese Methode ist nicht mit allen Seitenelementen kompatibel. Informationen dazu, welche Seitenelemente mit dieser Methode nicht kompatibel sind, finden Sie unter Einschränkungen bei Größe und Positionierung.
Rückflug
Number
: Die Höhe des Seitenelements in Punkten oder null
, wenn das Seitenelement keine Höhe hat.
Autorisierung
Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getInherentHeight()
Gibt die Höhe des Elements in Punkten zurück.
Die Transformation des Seitenelements ist relativ zu seiner ursprünglichen Größe. Verwenden Sie die natürliche Größe in Verbindung mit der Transformation des Elements, um das endgültige Erscheinungsbild des Elements zu bestimmen.
Rückflug
Number
: Die Höhe des Seitenelements in Punkten oder null
, wenn das Seitenelement keine Höhe hat.
Autorisierung
Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getInherentWidth()
Gibt die Breite des Elements in Punkten zurück.
Die Transformation des Seitenelements ist relativ zu seiner ursprünglichen Größe. Verwenden Sie die natürliche Größe in Verbindung mit der Transformation des Elements, um das endgültige Erscheinungsbild des Elements zu bestimmen.
Rückflug
Number
: Die Breite des Seitenelements in Punkten oder null
, wenn das Seitenelement keine Breite hat.
Autorisierung
Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getLeft()
Gibt die horizontale Position des Elements in Punkten zurück, gemessen von der linken oberen Ecke der Seite, wenn das Element nicht gedreht ist.
Rückflug
Number
: Die horizontale Position dieses Elements in Punkten, ausgehend von der linken oberen Ecke der Seite.
Autorisierung
Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getLineCategory()
Ruft den LineCategory
der Zeile ab.
Rückflug
LineCategory
– Die Linienkategorie.
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
getLineFill()
Ruft den LineFill
der Zeile ab.
Rückflug
LineFill
: Die Füllungseinstellung dieser Linie.
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
getLineType()
Ruft den LineType
der Zeile ab.
Rückflug
LineType
: Der Typ dieser Linie.
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
getLink()
Gibt Link
oder null
zurück, wenn kein Link vorhanden ist.
const shape = SlidesApp.getActivePresentation().getSlides()[0].getShapes()[0]; const link = shape.getLink(); if (link != null) { Logger.log(`Shape has a link of type: ${link.getLinkType()}`); }
Rückflug
Link
: Der Link
oder null
, wenn kein Link vorhanden ist.
Autorisierung
Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getObjectId()
Die eindeutige ID für dieses Objekt. Die Objekt-IDs, die von Seiten und Seitenelementen verwendet werden, haben denselben Namespace.
Rückflug
String
: Die eindeutige ID für dieses Objekt.
Autorisierung
Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getPageElementType()
Gibt den Typ des Seitenelements als PageElementType
-Enum zurück.
Rückflug
PageElementType
: Der Typ des Seitenelements.
Autorisierung
Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getParentGroup()
Gibt die Gruppe zurück, zu der dieses Seitenelement gehört, oder null
, wenn das Element keiner Gruppe zugewiesen ist.
Rückflug
Group
: Die Gruppe, zu der dieses Seitenelement gehört, oder null
.
Autorisierung
Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getParentPage()
Gibt die Seite zurück, auf der sich dieses Seitenelement befindet.
Rückflug
Page
: Die Seite, auf der sich dieses Element befindet.
Autorisierung
Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getRotation()
Gibt den Drehwinkel des Elements im Uhrzeigersinn um seine Mitte in Grad zurück. Null Grad bedeutet, dass das Element nicht gedreht wird.
Rückflug
Number
: Der Drehwinkel in Grad zwischen 0 (inklusive) und 360 (exklusiv).
Autorisierung
Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getStart()
Gibt den Startpunkt der Linie zurück, gemessen vom linken oberen Eckpunkt der Seite.
Rückflug
Point
: Der Startpunkt der Linie.
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
getStartArrow()
Ruft das ArrowStyle
des Pfeils am Anfang der Zeile ab.
Rückflug
ArrowStyle
: Der Stil des Pfeils am Anfang dieser 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
getStartConnection()
Gibt die Verbindung am Anfang der Linie zurück oder null
, wenn keine Verbindung vorhanden ist.
Rückflug
ConnectionSite
– Die Verbindung am Anfang der 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
getTitle()
Gibt den Titel des Alt-Texts des Seitenelements zurück. Der Titel wird mit der Beschreibung kombiniert, um den Alt-Text anzuzeigen und vorzulesen.
Rückflug
String
: Der Titel des Alt-Texts des Seitenelements.
Autorisierung
Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getTop()
Die vertikale Position des Elements in Punkten, gemessen von der oberen linken Ecke der Seite, wenn das Element nicht gedreht ist.
Rückflug
Number
: Die vertikale Position dieses Elements in Punkten, ausgehend von der linken oberen Ecke der Seite.
Autorisierung
Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getTransform()
Gibt die Transformation des Seitenelements zurück.
Das visuelle Erscheinungsbild des Seitenelements wird durch seine absolute Transformation bestimmt. Um die absolute Transformation zu berechnen, müssen Sie die Transformation eines Seitenelements mit den Transformationen aller übergeordneten Gruppen vorkonkatenieren. Wenn sich das Seitenelement nicht in einer Gruppe befindet, entspricht seine absolute Transformation dem Wert in diesem Feld.
Rückflug
AffineTransform
: Die Transformation des Seitenelements.
Autorisierung
Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getWeight()
Gibt die Linienstärke in Punkten zurück.
Rückflug
Number
: Die Linienstärke in Punkten.
Autorisierung
Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getWidth()
Gibt die Breite des Elements in Punkten zurück. Das ist die Breite des Begrenzungsrahmens des Elements, wenn es nicht gedreht ist.
Diese Methode ist nicht mit allen Seitenelementen kompatibel. Informationen dazu, welche Seitenelemente mit dieser Methode nicht kompatibel sind, finden Sie unter Einschränkungen bei Größe und Positionierung.
Rückflug
Number
: Die Breite des Seitenelements in Punkten oder null
, wenn das Seitenelement keine Breite hat.
Autorisierung
Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
isConnector()
Gibt true
zurück, wenn die Linie ein Verbindungselement ist, andernfalls false
.
Ein Connector ist eine Art von Linie, mit der Verbindungsstellen auf den entsprechenden Seitenelementen verbunden werden. Jedes Ende des Anschlusses kann mit höchstens einer Anschlussstelle verbunden werden.
Rückflug
Boolean
– True
, wenn die Linie ein Verbindungselement ist, oder false
, wenn nicht.
Autorisierung
Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
preconcatenateTransform(transform)
Die angegebene Transformation wird mit der vorhandenen Transformation des Seitenelements vorkonkateniert.
newTransform = argument * existingTransform;
So verschieben Sie ein Seitenelement beispielsweise um 36 Punkte nach links:
const element = SlidesApp.getActivePresentation().getSlides()[0].getPageElements()[0]; element.preconcatenateTransform( SlidesApp.newAffineTransformBuilder().setTranslateX(-36.0).build(), );
Sie können die Transformation des Seitenelements auch durch setTransform(transform)
ersetzen.
Parameter
Name | Typ | Beschreibung |
---|---|---|
transform | AffineTransform | Die Transformation, die vor der Transformation dieses Seitenelements vorkonkateniert werden soll. |
Rückflug
Line
– dieses Seitenelement zur Verkettung
Autorisierung
Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
remove()
Entfernt das Seitenelement.
Wenn eine Group
nach dem Entfernen nur noch ein oder gar keine Seitenelemente enthält, wird auch die Gruppe selbst entfernt.
Wenn ein Platzhalter PageElement
in einem Master oder Layout entfernt wird, werden auch alle leeren vererbten Platzhalter entfernt.
Autorisierung
Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
removeLink()
Entfernt einen Link
.
const slides = SlidesApp.getActivePresentation().getSlides(); slides[1].getShapes()[0].removeLink();
reroute()
Start- und Endpunkt der Linie werden zu den beiden am nächsten gelegenen Verbindungsstellen auf den verbundenen Seitenelementen umgeleitet. Der Anfang und das Ende der Linie müssen mit verschiedenen Seitenelementen verbunden sein.
Rückflug
Line
– Die Linie.
Autorisierung
Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
scaleHeight(ratio)
Die Höhe des Elements wird mit dem angegebenen Verhältnis skaliert. Die Höhe des Elements entspricht der Höhe seines Begrenzungsrahmens, wenn das Element nicht gedreht ist.
Diese Methode ist nicht mit allen Seitenelementen kompatibel. Informationen dazu, welche Seitenelemente mit dieser Methode nicht kompatibel sind, finden Sie unter Einschränkungen bei Größe und Positionierung.
Parameter
Name | Typ | Beschreibung |
---|---|---|
ratio | Number | Das Verhältnis, um das die Höhe dieses Seitenelements skaliert werden soll. |
Rückflug
Line
– dieses Seitenelement zur Verkettung
Autorisierung
Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
scaleWidth(ratio)
Die Breite des Elements wird mit dem angegebenen Verhältnis skaliert. Die Breite des Elements entspricht der Breite des Begrenzungsrahmens, wenn das Element nicht gedreht ist.
Diese Methode ist nicht mit allen Seitenelementen kompatibel. Informationen dazu, welche Seitenelemente mit dieser Methode nicht kompatibel sind, finden Sie unter Einschränkungen bei Größe und Positionierung.
Parameter
Name | Typ | Beschreibung |
---|---|---|
ratio | Number | Das Verhältnis, um das die Breite dieses Seitenelements skaliert werden soll. |
Rückflug
Line
– dieses Seitenelement zur Verkettung
Autorisierung
Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
select()
Wählt nur die PageElement
in der aktiven Präsentation aus und entfernt alle vorherigen Auswahlen. Das entspricht dem Aufruf von select(replace)
mit true
.
Ein Script kann nur auf die Auswahl des Nutzers zugreifen, der das Script ausführt, und nur dann, wenn das Script an die Präsentation gebunden ist.
Dadurch wird das übergeordnete Element Page
der PageElement
als current page selection
festgelegt.
const slide = SlidesApp.getActivePresentation().getSlides()[0]; const pageElement = slide.getPageElements()[0]; // Only select this page element and replace any previous selection. pageElement.select();
Autorisierung
Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
select(replace)
Wählt das PageElement
in der aktiven Präsentation aus.
Ein Script kann nur auf die Auswahl des Nutzers zugreifen, der das Script ausführt, und nur dann, wenn das Script an die Präsentation gebunden ist.
Wenn Sie true
an diese Methode übergeben, wird nur PageElement
ausgewählt und alle vorherigen Auswahlen werden entfernt. Dadurch wird auch die übergeordnete Page
der PageElement
als current page selection
festgelegt.
Geben Sie false
ein, um mehrere PageElement
-Objekte auszuwählen. Die PageElement
-Objekte müssen sich im selben Page
befinden.
Bei der Auswahl eines Seitenelements mit einem false
-Parameter müssen die folgenden Bedingungen erfüllt sein:
- Das übergeordnete
Page
-Element desPageElement
-Objekts musscurrent page selection
sein. - Es sollten nicht mehrere
Page
-Objekte ausgewählt sein.
Um dies sicherzustellen, sollten Sie zuerst das übergeordnete Element Page
mit Page.selectAsCurrentPage()
auswählen und dann die Seitenelemente auf dieser Seite.
const slide = SlidesApp.getActivePresentation().getSlides()[0]; // First select the slide page, as the current page selection. slide.selectAsCurrentPage(); // Then select all the page elements in the selected slide page. const pageElements = slide.getPageElements(); for (let i = 0; i < pageElements.length; i++) { pageElements[i].select(false); }
Parameter
Name | Typ | Beschreibung |
---|---|---|
replace | Boolean | Wenn true , ersetzt die Auswahl eine vorherige Auswahl. Andernfalls wird die Auswahl einer vorherigen Auswahl hinzugefügt. |
Autorisierung
Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
sendBackward()
Versetzt das Seitenelement auf der Seite um ein Element zurück.
Das Seitenelement darf sich nicht in einer Gruppe befinden.
Rückflug
Line
– dieses Seitenelement zur Verkettung
Autorisierung
Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
sendToBack()
Versetzt das Seitenelement ans Ende der Seite.
Das Seitenelement darf sich nicht in einer Gruppe befinden.
Rückflug
Line
– dieses Seitenelement zur Verkettung
Autorisierung
Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
setDashStyle(style)
Legt die DashStyle
der Linie fest.
Parameter
Name | Typ | Beschreibung |
---|---|---|
style | DashStyle | Der Stil der Strichsetzung für diese Linie. |
Rückflug
Line
– Diese Zeile für die Verkettung.
Autorisierung
Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
setDescription(description)
Hiermit wird die Alt-Text-Beschreibung des Seitenelements festgelegt.
Die Methode wird für Group
-Elemente nicht unterstützt.
// Set the first page element's alt text description to "new alt text // description". const pageElement = SlidesApp.getActivePresentation().getSlides()[0].getPageElements()[0]; pageElement.setDescription('new alt text description'); Logger.log(pageElement.getDescription());
Parameter
Name | Typ | Beschreibung |
---|---|---|
description | String | Der String, der als Alt-Text festgelegt werden soll. |
Rückflug
Line
– dieses Seitenelement.
Autorisierung
Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
setEnd(left, top)
Legt die Position des Endpunkts der Linie fest.
Der Linienverlauf kann nach der Positionierung angepasst werden.
Parameter
Name | Typ | Beschreibung |
---|---|---|
left | Number | Die horizontale Position des Endpunkts der Linie, gemessen in Punkten vom linken oberen Eckpunkt der Seite aus. |
top | Number | Die vertikale Position des Endpunkts der Linie, gemessen in Punkten vom linken oberen Seitenrand aus. |
Rückflug
Line
– Diese Zeile für die Verkettung.
Autorisierung
Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
setEnd(point)
Legt die Position des Endpunkts der Linie fest.
Der Linienverlauf kann nach der Positionierung angepasst werden.
Parameter
Name | Typ | Beschreibung |
---|---|---|
point | Point | Der Endpunkt der Linie, dessen Position von der linken oberen Ecke der Seite aus gemessen wird. |
Rückflug
Line
– Diese Zeile für die Verkettung.
Autorisierung
Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
setEndArrow(style)
Hiermit wird die ArrowStyle
des Pfeils am Ende der Linie festgelegt.
Parameter
Name | Typ | Beschreibung |
---|---|---|
style | ArrowStyle | Der Stil, der festgelegt werden soll. |
Rückflug
Line
– Diese Zeile für die Verkettung.
Autorisierung
Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
setEndConnection(connectionSite)
Legt die Verbindung am Ende der Linie fest. Dabei wird das Ende der Linie an die angegebene Verbindungsstelle verschoben, während das andere Ende intakt bleibt.
Parameter
Name | Typ | Beschreibung |
---|---|---|
connectionSite | ConnectionSite | Die Verbindungswebsite, auf die die Endverbindung aktualisiert wird, oder null , wenn die Endverbindung entfernt wird. |
Rückflug
Line
– Die Linie.
Autorisierung
Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
setHeight(height)
Hiermit wird die Höhe des Elements in Punkten festgelegt. Das ist die Höhe des Begrenzungsrahmens des Elements, wenn es nicht gedreht ist.
Diese Methode ist nicht mit allen Seitenelementen kompatibel. Informationen dazu, welche Seitenelemente mit dieser Methode nicht kompatibel sind, finden Sie unter Einschränkungen bei Größe und Positionierung.
Parameter
Name | Typ | Beschreibung |
---|---|---|
height | Number | Die neue Höhe dieses Seitenelements in Punkten. |
Rückflug
Line
– dieses Seitenelement zur Verkettung
Autorisierung
Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
setLeft(left)
Legt die horizontale Position des Elements in Punkten fest, gemessen von der linken oberen Ecke der Seite, wenn das Element nicht gedreht ist.
Parameter
Name | Typ | Beschreibung |
---|---|---|
left | Number | Die neue horizontale Position in Punkten. |
Rückflug
Line
– dieses Seitenelement zur Verkettung
Autorisierung
Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
setLineCategory(lineCategory)
Legt die LineCategory
der Linie fest.
Sie können die Kategorie nur auf connectors
festlegen. Der Anschluss wird möglicherweise umgeleitet, nachdem die Kategorie geändert wurde.
Parameter
Name | Typ | Beschreibung |
---|---|---|
lineCategory | LineCategory | Die Linienkategorie, die festgelegt werden soll. |
Rückflug
Line
– Die Linie.
Autorisierung
Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
setLinkSlide(slideIndex)
Legt mit dem nullbasierten Index der Folie eine Link
für die angegebene Slide
fest.
// Set a link to the first slide of the presentation. const slides = SlidesApp.getActivePresentation().getSlides(); const shape = slides[1].getShapes()[0]; const link = shape.setLinkSlide(0);
Parameter
Name | Typ | Beschreibung |
---|---|---|
slideIndex | Integer | Der nullbasierte Index der Folie. |
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
setLinkSlide(slide)
Hier wird eine Link
auf die angegebene Slide
festgelegt. Der Link wird anhand der angegebenen Folien-ID festgelegt.
// Set a link to the first slide of the presentation. const slides = SlidesApp.getActivePresentation().getSlides(); const shape = slides[1].getShapes()[0]; const link = shape.setLinkSlide(slides[0]);
Parameter
Name | Typ | Beschreibung |
---|---|---|
slide | Slide | Die zu verknüpfende Slide . |
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
setLinkSlide(slidePosition)
Legt mithilfe der relativen Position der Folie einen Link
für die angegebene Slide
fest.
// Set a link to the first slide of the presentation. const slides = SlidesApp.getActivePresentation().getSlides(); const shape = slides[1].getShapes()[0]; const link = shape.setLinkSlide(SlidesApp.SlidePosition.FIRST_SLIDE);
Parameter
Name | Typ | Beschreibung |
---|---|---|
slidePosition | SlidePosition | Das relative SlidePosition . |
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
setLinkUrl(url)
Legt einen Link
für den angegebenen nicht leeren URL-String fest.
// Set a link to the URL. const slides = SlidesApp.getActivePresentation().getSlides(); const shape = slides[1].getShapes()[0]; const link = shape.setLinkUrl('https://slides.google.com');
Parameter
Name | Typ | Beschreibung |
---|---|---|
url | String | Der URL-String. |
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
setRotation(angle)
Legt den Drehwinkel des Elements im Uhrzeigersinn um seine Mitte in Grad fest.
Diese Methode ist nicht mit allen Seitenelementen kompatibel. Informationen dazu, welche Seitenelemente mit dieser Methode nicht kompatibel sind, finden Sie unter Einschränkungen bei Größe und Positionierung.
Parameter
Name | Typ | Beschreibung |
---|---|---|
angle | Number | Der neue Drehwinkel im Uhrzeigersinn in Grad. |
Rückflug
Line
– dieses Seitenelement zur Verkettung
Autorisierung
Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
setStart(left, top)
Legt die Position des Startpunkts der Linie fest.
Der Linienverlauf kann nach der Positionierung angepasst werden.
Parameter
Name | Typ | Beschreibung |
---|---|---|
left | Number | Die horizontale Position des Startpunkts der Linie, gemessen in Punkten vom linken oberen Eckpunkt der Seite aus. |
top | Number | Die vertikale Position des Startpunkts der Linie, gemessen in Punkten von der linken oberen Ecke der Seite aus. |
Rückflug
Line
– Diese Zeile für die Verkettung.
Autorisierung
Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
setStart(point)
Legt die Position des Startpunkts der Linie fest.
Der Linienverlauf kann nach der Positionierung angepasst werden.
Parameter
Name | Typ | Beschreibung |
---|---|---|
point | Point | Der Startpunkt der Linie, dessen Position von der linken oberen Ecke der Seite aus gemessen wird. |
Rückflug
Line
– Diese Zeile für die Verkettung.
Autorisierung
Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
setStartArrow(style)
Legt die ArrowStyle
des Pfeils am Anfang der Zeile fest.
Parameter
Name | Typ | Beschreibung |
---|---|---|
style | ArrowStyle | Der neue Pfeilstil, der festgelegt werden soll. |
Rückflug
Line
– Diese Zeile für die Verkettung.
Autorisierung
Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
setStartConnection(connectionSite)
Legt die Verbindung am Anfang der Zeile fest. Dabei wird der Anfang der Linie an die angegebene Verbindungsstelle verschoben, während das andere Ende intakt bleibt.
Parameter
Name | Typ | Beschreibung |
---|---|---|
connectionSite | ConnectionSite | Die Verbindungsstelle, auf die die Startverbindung aktualisiert wird, oder null , wenn die Startverbindung entfernt wird. |
Rückflug
Line
– Die Linie.
Autorisierung
Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
setTitle(title)
Hiermit wird der Titel des Alt-Texts für das Seitenelement festgelegt.
Die Methode wird für Group
-Elemente nicht unterstützt.
// Set the first page element's alt text title to "new alt text title". const pageElement = SlidesApp.getActivePresentation().getSlides()[0].getPageElements()[0]; pageElement.setTitle('new alt text title'); Logger.log(pageElement.getTitle());
Parameter
Name | Typ | Beschreibung |
---|---|---|
title | String | Der String, auf den der Titel des Alt-Texts festgelegt werden soll. |
Rückflug
Line
– dieses Seitenelement.
Autorisierung
Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
setTop(top)
Legt die vertikale Position des Elements in Punkten fest, gemessen von der linken oberen Ecke der Seite, wenn das Element nicht gedreht ist.
Parameter
Name | Typ | Beschreibung |
---|---|---|
top | Number | Die neue vertikale Position in Punkten. |
Rückflug
Line
– dieses Seitenelement zur Verkettung
Autorisierung
Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
setTransform(transform)
Legt die Transformation des Seitenelements mit der angegebenen Transformation fest.
Wenn Sie die Transformation einer Gruppe aktualisieren, ändert sich die absolute Transformation der Seitenelemente in dieser Gruppe, was sich auf ihr visuelles Erscheinungsbild auswirken kann.
Wenn Sie die Transformation eines Seitenelements in einer Gruppe aktualisieren, ändert sich nur die Transformation dieses Seitenelements. Die Transformationen der Gruppe oder anderer Seitenelemente in der Gruppe bleiben unverändert.
Weitere Informationen dazu, wie sich Transformationen auf das Erscheinungsbild von Seitenelementen auswirken, finden Sie unter getTransform()
.
Parameter
Name | Typ | Beschreibung |
---|---|---|
transform | AffineTransform | Die Transformation, die für dieses Seitenelement festgelegt ist. |
Rückflug
Line
– Dieses Element für die Verkettung.
Autorisierung
Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
setWeight(points)
Hier legen Sie die Linienstärke in Punkten fest.
Parameter
Name | Typ | Beschreibung |
---|---|---|
points | Number | Die neue Linienstärke in Punkten. |
Rückflug
Line
– Diese Zeile für die Verkettung.
Autorisierung
Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
setWidth(width)
Hiermit wird die Breite des Elements in Punkten festgelegt. Das ist die Breite des Begrenzungsrahmens des Elements, wenn es nicht gedreht ist.
Diese Methode ist nicht mit allen Seitenelementen kompatibel. Informationen dazu, welche Seitenelemente mit dieser Methode nicht kompatibel sind, finden Sie unter Einschränkungen bei Größe und Positionierung.
Parameter
Name | Typ | Beschreibung |
---|---|---|
width | Number | Die neue Breite dieses Seitenelements in Punkten. |
Rückflug
Line
– dieses Seitenelement zur Verkettung
Autorisierung
Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations