Class Line

Linie

Ein PageElement, das eine Zeile darstellt.

Methoden

MethodeRückgabetypKurzbeschreibung
alignOnPage(alignmentPosition)LineRichtet das Element an der angegebenen Ausrichtungsposition auf der Seite aus.
bringForward()LineBringt das Seitenelement auf der Seite um ein Element nach vorn.
bringToFront()LineDas Seitenelement wird in den Vordergrund gerückt.
duplicate()PageElementDupliziert das Seitenelement.
getConnectionSites()ConnectionSite[]Gibt die Liste der ConnectionSites für das Seitenelement zurück oder eine leere Liste, wenn das Seitenelement keine Verbindungspunkte hat.
getDashStyle()DashStyleRuft die DashStyle der Zeile ab.
getDescription()StringGibt die Alt-Text-Beschreibung des Seitenelements zurück.
getEnd()PointGibt den Endpunkt der Linie zurück, gemessen von der oberen linken Ecke der Seite.
getEndArrow()ArrowStyleRuft die ArrowStyle des Pfeils am Ende der Linie ab.
getEndConnection()ConnectionSite|nullGibt die Verbindung am Ende der Zeile zurück oder null, wenn keine Verbindung vorhanden ist.
getHeight()Number|nullGibt die Höhe des Elements in Punkten zurück. Das ist die Höhe des umgebenden Rechtecks des Elements, wenn das Element nicht gedreht ist.
getInherentHeight()Number|nullGibt die inhärente Höhe des Elements in Punkten zurück.
getInherentWidth()Number|nullGibt die inhärente Breite des Elements in Punkten zurück.
getLeft()NumberGibt die horizontale Position des Elements in Punkten zurück, gemessen an der oberen linken Ecke der Seite, wenn das Element nicht gedreht ist.
getLineCategory()LineCategoryRuft die LineCategory der Zeile ab.
getLineFill()LineFillRuft die LineFill der Zeile ab.
getLineType()LineTypeRuft die LineType der Zeile ab.
getLink()Link|nullGibt den Link oder null zurück, wenn kein Link vorhanden ist.
getObjectId()StringGibt die eindeutige ID für dieses Objekt zurück.
getPageElementType()PageElementTypeGibt den Typ des Seitenelements als PageElementType-Enum zurück.
getParentGroup()Group|nullGibt die Gruppe zurück, zu der dieses Seitenelement gehört, oder null, wenn das Element nicht in einer Gruppe ist.
getParentPage()PageGibt die Seite zurück, auf der sich dieses Seitenelement befindet.
getRotation()NumberGibt den Drehwinkel des Elements im Uhrzeigersinn um seinen Mittelpunkt in Grad zurück. Null Grad bedeutet keine Drehung.
getStart()PointGibt den Startpunkt der Linie zurück, gemessen von der oberen linken Ecke der Seite.
getStartArrow()ArrowStyleRuft die ArrowStyle des Pfeils am Anfang der Zeile ab.
getStartConnection()ConnectionSite|nullGibt die Verbindung am Anfang der Zeile zurück oder null, wenn keine Verbindung vorhanden ist.
getTitle()StringGibt den Titel des Alt-Texts des Seitenelements zurück.
getTop()NumberGibt die vertikale Position des Elements in Punkten an, gemessen von der oberen linken Ecke der Seite, wenn das Element nicht gedreht ist.
getTransform()AffineTransformGibt die Transformation des Seitenelements zurück.
getWeight()NumberGibt die Linienstärke in Punkten zurück.
getWidth()Number|nullGibt die Breite des Elements in Punkten zurück. Das ist die Breite des umgebenden Rechtecks des Elements, wenn das Element nicht gedreht ist.
isConnector()BooleanGibt true zurück, wenn die Linie ein Verbinder ist, andernfalls false.
preconcatenateTransform(transform)LineFügt die angegebene Transformation vor der vorhandenen Transformation des Seitenelements ein.
remove()voidEntfernt das Seitenelement.
removeLink()voidEntfernt einen Link.
reroute()LineLeitet den Anfang und das Ende der Linie zu den beiden nächstgelegenen Verbindungspunkten der verbundenen Seitenelemente um.
scaleHeight(ratio)LineSkaliert die Höhe des Elements um das angegebene Verhältnis.
scaleWidth(ratio)LineSkaliert die Breite des Elements um das angegebene Verhältnis.
select()voidEs wird nur die PageElement in der aktiven Präsentation ausgewählt und alle vorherigen Auswahlen werden entfernt.
select(replace)voidWählt das PageElement in der aktiven Präsentation aus.
sendBackward()LineVersetzt das Seitenelement um ein Element nach hinten.
sendToBack()LineVersetzt das Seitenelement in den Hintergrund.
setDashStyle(style)LineLegt die DashStyle der Linie fest.
setDescription(description)LineLegt die Alt-Text-Beschreibung des Seitenelements fest.
setEnd(left, top)LineLegt die Position des Endpunkts der Linie fest.
setEnd(point)LineLegt die Position des Endpunkts der Linie fest.
setEndArrow(style)LineLegt die ArrowStyle des Pfeils am Ende der Linie fest.
setEndConnection(connectionSite)LineLegt die Verbindung am Ende der Linie fest.
setHeight(height)LineLegt die Höhe des Elements in Punkten fest. Das ist die Höhe des umgebenden Rechtecks des Elements, wenn das Element nicht gedreht ist.
setLeft(left)LineLegt die horizontale Position des Elements in Punkten fest, gemessen von der oberen linken Ecke der Seite, wenn das Element nicht gedreht ist.
setLineCategory(lineCategory)LineLegt die LineCategory der Linie fest.
setLinkSlide(slideIndex)LinkLegt einen Link auf die angegebene Slide fest unter Verwendung des nullbasierten Folienindex.
setLinkSlide(slide)LinkLegt einen Link auf die angegebene Slide fest unter Verwendung der angegebenen Folien‑ID.
setLinkSlide(slidePosition)LinkLegt einen Link auf die angegebene Slide fest unter Verwendung der relativen Position der Folie.
setLinkUrl(url)LinkLegt einen Link auf den angegebenen nicht leeren URL‑String fest.
setRotation(angle)LineLegt den Drehwinkel des Elements im Uhrzeigersinn um seinen Mittelpunkt in Grad fest.
setStart(left, top)LineLegt die Position des Startpunkts der Linie fest.
setStart(point)LineLegt die Position des Startpunkts der Linie fest.
setStartArrow(style)LineLegt die ArrowStyle des Pfeils am Anfang der Linie fest.
setStartConnection(connectionSite)LineLegt die Verbindung am Anfang der Zeile fest.
setTitle(title)LineLegt den Titel des Alt-Texts für das Seitenelement fest.
setTop(top)LineLegt die vertikale Position des Elements in Punkten fest, gemessen von der oberen linken Ecke der Seite, wenn das Element nicht gedreht ist.
setTransform(transform)LineLegt die Transformation des Seitenelements mit der angegebenen Transformation fest.
setWeight(points)LineLegt die Stärke der Linie in Punkten fest.
setWidth(width)LineLegt die Breite des Elements in Punkten fest. Das ist die Breite des umgebenden Rechtecks des Elements, wenn das Element nicht gedreht ist.

Detaillierte Dokumentation

alignOnPage(alignmentPosition)

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

Parameter

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

Rückflug

Line: Dieses Seitenelement zur Verkettung.


bringForward()

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

Das Seitenelement darf sich nicht in einer Gruppe befinden.

Rückflug

Line: Dieses Seitenelement zur Verkettung.

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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

bringToFront()

Das Seitenelement wird in den Vordergrund gerückt.

Das Seitenelement darf sich nicht in einer Gruppe befinden.

Rückflug

Line: Dieses Seitenelement zur Verkettung.

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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

duplicate()

Dupliziert das Seitenelement.

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

Rückflug

PageElement: Das neue Duplikat dieses Seitenelements.

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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

getConnectionSites()

Gibt die Liste der ConnectionSites für das Seitenelement zurück oder eine leere Liste, wenn das Seitenelement keine Verbindungspunkte hat.

Rückflug

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

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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

getDashStyle()

Ruft die DashStyle der Zeile ab.

Rückflug

DashStyle: Der Stil der Strichelung, die für diese Linie verwendet wird.

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

  • 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 Alt-Text anzuzeigen und vorzulesen.

Rückflug

String: Die Alt-Text-Beschreibung des Seitenelements.

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

  • 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, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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

getEndArrow()

Ruft die ArrowStyle des Pfeils am Ende der Linie ab.

Rückflug

ArrowStyle: Der Stil des Pfeils am Ende dieser Linie.

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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

getEndConnection()

Gibt die Verbindung am Ende der Zeile zurück oder null, wenn keine Verbindung vorhanden ist.

Rückflug

ConnectionSite|null: Die Verbindung am Ende der Leitung.

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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

getHeight()

Gibt die Höhe des Elements in Punkten zurück. Das ist die Höhe des umgebenden Rechtecks des Elements, wenn das Element nicht gedreht ist.

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

Rückflug

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

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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

getInherentHeight()

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

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

Rückflug

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

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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

getInherentWidth()

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

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

Rückflug

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

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

  • 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 an der oberen linken Ecke der Seite, wenn das Element nicht gedreht ist.

Rückflug

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

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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

getLineCategory()

Ruft die LineCategory der Zeile ab.

Rückflug

LineCategory – Die Zeilenkategorie.

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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

getLineFill()

Ruft die LineFill der Zeile ab.

Rückflug

LineFill: Die Fülleinstellung dieser Zeile.

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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

getLineType()

Ruft die LineType der Zeile ab.

Rückflug

LineType: Der Typ dieser Zeile.

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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

Gibt den 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|null – Der Link oder null, wenn kein Link vorhanden ist.

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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

getObjectId()

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

Rückflug

String: Die eindeutige ID für dieses Objekt.

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

  • 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, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

  • 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 nicht in einer Gruppe ist.

Rückflug

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

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

  • 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, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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

getRotation()

Gibt den Drehwinkel des Elements im Uhrzeigersinn um seinen Mittelpunkt in Grad zurück. Null Grad bedeutet keine Drehung.

Rückflug

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

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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

getStart()

Gibt den Startpunkt der Linie zurück, gemessen von der oberen linken Ecke der Seite.

Rückflug

Point: Der Startpunkt der Linie.

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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

getStartArrow()

Ruft die 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, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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

getStartConnection()

Gibt die Verbindung am Anfang der Zeile zurück oder null, wenn keine Verbindung vorhanden ist.

Rückflug

ConnectionSite|null: Die Verbindung am Anfang der Zeile.

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

  • 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 Alt-Text anzuzeigen und vorzulesen.

Rückflug

String: Der Alt-Text-Titel des Seitenelements.

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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

getTop()

Gibt die vertikale Position des Elements in Punkten an, 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 oberen linken Ecke der Seite.

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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

getTransform()

Gibt die Transformation des Seitenelements zurück.

Das 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 verketten. 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, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

  • 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 Stärke der Linie in Punkten.

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

  • 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 umgebenden Rechtecks des Elements, wenn das Element nicht gedreht ist.

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

Rückflug

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

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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

isConnector()

Gibt true zurück, wenn die Linie ein Verbinder ist, andernfalls false.

Ein Connector ist eine Art von Linie, mit der Verbindungsstellen auf entsprechenden Seitenelementen verbunden werden. Jedes Ende des Steckers kann mit höchstens einem Anschluss verbunden werden.

Rückflug

Boolean – True, wenn die Linie ein Connector ist, oder false, wenn nicht.

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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

preconcatenateTransform(transform)

Fügt die angegebene Transformation vor der vorhandenen Transformation des Seitenelements ein.

newTransform = argument * existingTransform;

Wenn Sie ein Seitenelement beispielsweise um 36 Punkte nach links verschieben möchten:

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

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

Parameter

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

Rückflug

Line: Dieses Seitenelement zur Verkettung.

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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

remove()

Entfernt das Seitenelement.

Wenn ein Group nach dem Entfernen nur ein oder kein Seitenelement enthält, wird auch die Gruppe selbst entfernt.

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

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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

Entfernt einen Link.

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

reroute()

Leitet den Anfang und das Ende der Linie zu den beiden nächstgelegenen Verbindungspunkten der verbundenen Seitenelemente um. 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, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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

scaleHeight(ratio)

Skaliert die Höhe des Elements um das angegebene Verhältnis. Die Höhe des Elements ist die Höhe seines umgebenden Rechtecks, wenn das Element nicht gedreht ist.

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

Parameter

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

Rückflug

Line: Dieses Seitenelement zur Verkettung.

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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

scaleWidth(ratio)

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

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

Parameter

NameTypBeschreibung
ratioNumberDas Verhältnis, mit dem die Breite dieses Seitenelements skaliert werden soll.

Rückflug

Line: Dieses Seitenelement zur Verkettung.

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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

select()

Es wird nur die PageElement in der aktiven Präsentation ausgewählt und alle vorherigen Auswahlen werden entfernt. Dies entspricht dem Aufrufen von select(replace) mit true.

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

Dadurch wird das übergeordnete Page des 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, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

  • 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 Skript kann nur auf die Auswahl des Nutzers zugreifen, der das Skript ausführt, und nur, wenn das Skript an die Präsentation gebunden ist.

Übergeben Sie true an diese Methode, um nur PageElement auszuwählen und alle vorherigen Auswahlen zu entfernen. Dadurch wird auch der übergeordnete Page des PageElement als current page selection festgelegt.

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

Die folgenden Bedingungen müssen erfüllt sein, wenn Sie ein Seitenelement mit einem false-Parameter auswählen:

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

Um sicherzugehen, dass das der Fall ist, sollten Sie zuerst das übergeordnete Element Page mit Page.selectAsCurrentPage() auswählen und dann die Seitenelemente auf dieser Seite.

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

Parameter

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

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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

sendBackward()

Versetzt das Seitenelement um ein Element nach hinten.

Das Seitenelement darf sich nicht in einer Gruppe befinden.

Rückflug

Line: Dieses Seitenelement zur Verkettung.

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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

sendToBack()

Versetzt das Seitenelement in den Hintergrund.

Das Seitenelement darf sich nicht in einer Gruppe befinden.

Rückflug

Line: Dieses Seitenelement zur Verkettung.

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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

setDashStyle(style)

Legt die DashStyle der Linie fest.

Parameter

NameTypBeschreibung
styleDashStyleDer Stil der Strichelung, die für diese Linie festgelegt werden soll.

Rückflug

Line – Diese Zeile zur Verkettung.

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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

setDescription(description)

Legt die Alt-Text-Beschreibung des Seitenelements fest.

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

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

Parameter

NameTypBeschreibung
descriptionStringDer String, auf den die Alt-Text-Beschreibung festgelegt werden soll.

Rückflug

Line: Dieses Seitenelement.

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

  • 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 Linienpfad kann nach einer Positionsänderung angepasst werden.

Parameter

NameTypBeschreibung
leftNumberDie horizontale Position des Endpunkts der Linie, gemessen in Punkten von der oberen linken Ecke der Seite aus.
topNumberDie vertikale Position des Endpunkts der Linie, gemessen in Punkten von der oberen linken Ecke der Seite.

Rückflug

Line – Diese Zeile zur Verkettung.

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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

setEnd(point)

Legt die Position des Endpunkts der Linie fest.

Der Linienpfad kann nach einer Positionsänderung angepasst werden.

Parameter

NameTypBeschreibung
pointPointDer Endpunkt der Linie, dessen Position relativ zur oberen linken Ecke der Seite gemessen wird.

Rückflug

Line – Diese Zeile zur Verkettung.

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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

setEndArrow(style)

Legt die ArrowStyle des Pfeils am Ende der Linie fest.

Parameter

NameTypBeschreibung
styleArrowStyleDer festzulegende Stil.

Rückflug

Line – Diese Zeile zur Verkettung.

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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

setEndConnection(connectionSite)

Legt die Verbindung am Ende der Linie fest. Das Ende der Linie wird an die angegebene Verbindungsstelle verschoben, während das andere Ende unverändert bleibt.

Parameter

NameTypBeschreibung
connectionSiteConnectionSiteDie Verbindungsstelle, zu der die Endverbindung aktualisiert wird, oder null, wenn die Endverbindung entfernt wird.

Rückflug

Line – Die Linie.

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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

setHeight(height)

Legt die Höhe des Elements in Punkten fest. Das ist die Höhe des umgebenden Rechtecks des Elements, wenn das Element nicht gedreht ist.

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

Parameter

NameTypBeschreibung
heightNumberDie neue Höhe dieses Seitenelements in Punkten.

Rückflug

Line: Dieses Seitenelement zur Verkettung.

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

  • 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 oberen linken Ecke der Seite, wenn das Element nicht gedreht ist.

Parameter

NameTypBeschreibung
leftNumberDie neue horizontale Position, die festgelegt werden soll, in Punkten.

Rückflug

Line: Dieses Seitenelement zur Verkettung.

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

  • 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 Connector wird möglicherweise umgeleitet, nachdem seine Kategorie geändert wurde.

Parameter

NameTypBeschreibung
lineCategoryLineCategoryDie festzulegende Linienkategorie.

Rückflug

Line – Die Linie.

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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

setLinkSlide(slideIndex)

Legt einen Link auf die angegebene Slide fest unter Verwendung des nullbasierten Folienindex.

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

Parameter

NameTypBeschreibung
slideIndexIntegerNullbasierter Index der Folie

Rückflug

Link – Die Link, die festgelegt wurde.

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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

setLinkSlide(slide)

Legt einen Link auf die angegebene Slide fest unter Verwendung der angegebenen Folien‑ID.

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

Parameter

NameTypBeschreibung
slideSlideSlide, auf die der Link verweisen soll

Rückflug

Link – Die Link, die festgelegt wurde.

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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

setLinkSlide(slidePosition)

Legt einen Link auf die angegebene Slide fest unter Verwendung der relativen Position der Folie.

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

Parameter

NameTypBeschreibung
slidePositionSlidePositionRelative SlidePosition

Rückflug

Link – Die Link, die festgelegt wurde.

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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

setLinkUrl(url)

Legt einen Link auf den angegebenen nicht leeren URL‑String fest.

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

Parameter

NameTypBeschreibung
urlStringURL‑String

Rückflug

Link – Die Link, die festgelegt wurde.

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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

setRotation(angle)

Legt den Drehwinkel des Elements im Uhrzeigersinn um seinen Mittelpunkt in Grad fest.

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

Parameter

NameTypBeschreibung
angleNumberDer neue Drehwinkel im Uhrzeigersinn, der festgelegt werden soll, in Grad.

Rückflug

Line: Dieses Seitenelement zur Verkettung.

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

  • 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 Linienpfad kann nach einer Positionsänderung angepasst werden.

Parameter

NameTypBeschreibung
leftNumberDie horizontale Position des Startpunkts der Linie, gemessen in Punkten von der oberen linken Ecke der Seite.
topNumberDie vertikale Position des Startpunkts der Linie, gemessen in Punkten von der oberen linken Ecke der Seite aus.

Rückflug

Line – Diese Zeile zur Verkettung.

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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

setStart(point)

Legt die Position des Startpunkts der Linie fest.

Der Linienpfad kann nach einer Positionsänderung angepasst werden.

Parameter

NameTypBeschreibung
pointPointDer Startpunkt der Linie, dessen Position von der oberen linken Ecke der Seite aus gemessen wird.

Rückflug

Line – Diese Zeile zur Verkettung.

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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

setStartArrow(style)

Legt die ArrowStyle des Pfeils am Anfang der Linie fest.

Parameter

NameTypBeschreibung
styleArrowStyleDer neue Pfeilstil, der festgelegt werden soll.

Rückflug

Line – Diese Zeile zur Verkettung.

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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

setStartConnection(connectionSite)

Legt die Verbindung am Anfang der Zeile fest. Dadurch wird der Anfang der Linie an die angegebene Verbindungsstelle verschoben, während das andere Ende unverändert bleibt.

Parameter

NameTypBeschreibung
connectionSiteConnectionSiteDie Verbindung, auf die die Startverbindung aktualisiert wird, oder null, wenn die Startverbindung entfernt wird.

Rückflug

Line – Die Linie.

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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

setTitle(title)

Legt den Titel des Alt-Texts für das Seitenelement fest.

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

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

Parameter

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

Rückflug

Line: Dieses Seitenelement.

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

  • 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 oberen linken Ecke der Seite, wenn das Element nicht gedreht ist.

Parameter

NameTypBeschreibung
topNumberDie neue vertikale Position, die festgelegt werden soll, in Punkten.

Rückflug

Line: Dieses Seitenelement zur Verkettung.

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

  • 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 Erscheinungsbild auswirken kann.

Wenn Sie die Transformation eines Seitenelements in einer Gruppe aktualisieren, wird nur die Transformation dieses Seitenelements geändert. Die Transformationen der Gruppe oder anderer Seitenelemente in der Gruppe sind davon nicht betroffen.

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

Parameter

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

Rückflug

Line: Dieses Element zur Verkettung.

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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

setWeight(points)

Legt die Stärke der Linie in Punkten fest.

Parameter

NameTypBeschreibung
pointsNumberDie neue Linienstärke in Punkten.

Rückflug

Line – Diese Zeile zur Verkettung.

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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

setWidth(width)

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

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

Parameter

NameTypBeschreibung
widthNumberDie neue Breite dieses Seitenelements in Punkten.

Rückflug

Line: Dieses Seitenelement zur Verkettung.

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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