Class Line

Linie

Ein PageElement, das eine Linie darstellt.

Methoden

MethodeRückgabetypKurzbeschreibung
alignOnPage(alignmentPosition)LineRichtet das Element an der angegebenen Position auf der Seite aus.
bringForward()LineBringt das Seitenelement auf der Seite um ein Element nach vorn
bringToFront()LineBringt das Seitenelement in den Vordergrund der Seite
duplicate()PageElementDupliziert das Seitenelement.
getConnectionSites()ConnectionSite[]Gibt die Liste der ConnectionSites für das Seitenelement oder eine leere Liste zurück, wenn das Seitenelement keine Verbindungswebsites hat.
getDashStyle()DashStyleRuft den DashStyle der Zeile ab.
getDescription()StringGibt die Alt-Textbeschreibung des Seitenelements zurück
getEnd()PointGibt den Endpunkt der Linie zurück, gemessen von der oberen linken Ecke der Seite aus.
getEndArrow()ArrowStyleRuft das ArrowStyle des Pfeils am Ende der Zeile ab.
getEndConnection()ConnectionSiteGibt die Verbindung am Ende der Zeile oder null zurück, wenn keine Verbindung vorhanden ist.
getHeight()NumberRuft die Höhe des Elements in Punkten ab. Dies ist die Höhe des Begrenzungsrahmens des Elements, wenn das Element keine Rotation hat.
getInherentHeight()NumberGibt die inhärente Höhe des Elements in Punkten zurück
getInherentWidth()NumberGibt die inhärente Breite des Elements in Punkten zurück.
getLeft()NumberGibt die horizontale Position des Elements in Punkten zurück, gemessen von der linken oberen Ecke der Seite aus, wenn das Element keine Drehung aufweist.
getLineCategory()LineCategoryRuft den LineCategory der Zeile ab.
getLineFill()LineFillRuft den LineFill der Zeile ab.
getLineType()LineTypeRuft den LineType der Zeile ab.
getLink()LinkGibt das Link oder null zurück, wenn kein Link vorhanden ist.
getObjectId()StringGibt die eindeutige ID für dieses Objekt zurück
getPageElementType()PageElementTypeGibt den Typ des Seitenelements zurück, dargestellt als PageElementType-Enum.
getParentGroup()GroupGibt die Gruppe zurück, zu der dieses Seitenelement gehört, oder null, wenn das Element nicht zu einer Gruppe gehört
getParentPage()PageGibt die Seite zurück, auf der sich das Seitenelement befindet
getRotation()NumberGibt den Rotationswinkel des Elements im Uhrzeigersinn um seinen Mittelpunkt in Grad zurück, wobei null Grad keine Drehung bedeutet.
getStart()PointGibt den Startpunkt der Linie zurück, gemessen von der oberen linken Ecke der Seite aus.
getStartArrow()ArrowStyleRuft den ArrowStyle des Pfeils am Anfang der Zeile ab.
getStartConnection()ConnectionSiteGibt die Verbindung am Anfang der Zeile oder null zurück, wenn keine Verbindung vorhanden ist.
getTitle()StringGibt den Alt-Texttitel des Seitenelements zurück
getTop()NumberRuft die vertikale Position des Elements in Punkten ab, gemessen von der linken oberen Ecke der Seite, wenn das Element keine Drehung aufweist.
getTransform()AffineTransformGibt die Transformation des Seitenelements zurück.
getWeight()NumberGibt die Linienstärke in Punkten zurück
getWidth()NumberGibt die Breite des Elements in Punkten zurück. Das ist die Breite des Begrenzungsrahmens des Elements, wenn das Element nicht gedreht wird.
isConnector()BooleanGibt true zurück, wenn die Linie eine Verbindung ist, oder false, wenn nicht.
preconcatenateTransform(transform)LineVerkettet die angegebene Transformation mit der vorhandenen Transformation des Seitenelements vor.
remove()voidEntfernt das Seitenelement.
removeLink()voidEntfernt einen Link.
reroute()LineDer Anfang und das Ende der Linie werden auf die beiden nächstgelegenen Verbindungsstellen in den verbundenen Seitenelementen umgeleitet.
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()voidWählt nur das PageElement in der aktiven Präsentation aus und entfernt jede vorherige Auswahl.
select(replace)voidWählt das PageElement in der aktiven Präsentation aus.
sendBackward()LineVersetzt das Seitenelement auf der Seite um ein Element nach hinten.
sendToBack()LineVersetzt das Seitenelement an den hinteren Teil der Seite
setDashStyle(style)LineLegt den DashStyle der Zeile fest.
setDescription(description)LineLegt die Alt-Textbeschreibung 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 den ArrowStyle des Pfeils am Ende der Linie fest.
setEndConnection(connectionSite)LineLegt die Verbindung am Ende der Zeile fest.
setHeight(height)LineLegt die Höhe des Elements in Punkten fest. Das ist die Höhe des Begrenzungsrahmens des Elements, wenn das Element nicht gedreht wird.
setLeft(left)LineLegt die horizontale Position des Elements in Punkten fest, gemessen von der linken oberen Ecke der Seite aus, wenn das Element keine Drehung aufweist.
setLineCategory(lineCategory)LineLegt den LineCategory der Zeile fest.
setLinkSlide(slideIndex)LinkLegt ein Link auf das angegebene Slide fest, wobei der nullbasierte Index der Folie verwendet wird.
setLinkSlide(slide)LinkLegt ein Link auf das angegebene Slide fest, der Link wird durch die angegebene Folien-ID festgelegt.
setLinkSlide(slidePosition)LinkLegt ein Link auf das angegebene Slide fest, wobei die relative Position der Folie verwendet wird.
setLinkUrl(url)LinkLegt einen Link auf den angegebenen nicht leeren URL-String fest.
setRotation(angle)LineLegt den Rotationswinkel 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 den ArrowStyle des Pfeils am Anfang der Zeile fest.
setStartConnection(connectionSite)LineLegt die Verbindung am Anfang der Zeile fest.
setTitle(title)LineLegt den Titel des Alt-Textes des Seitenelements fest.
setTop(top)LineLegt die vertikale Position des Elements in Punkten fest, gemessen von der linken oberen Ecke der Seite aus, wenn das Element nicht gedreht wird.
setTransform(transform)LineLegt die Transformation des Seitenelements mit der angegebenen Transformation fest.
setWeight(points)LineLegt die Linienstärke in Punkten fest.
setWidth(width)LineLegt die Breite des Elements in Punkten fest. Das ist die Breite des Begrenzungsrahmens des Elements, wenn das Element nicht gedreht wird.

Detaillierte Dokumentation

alignOnPage(alignmentPosition)

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

Parameter

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

Return

Line: Dieses Seitenelement zur Verkettung.

bringForward()

Bringt das Seitenelement auf der Seite um ein Element nach vorn

Das Seitenelement darf nicht zu einer Gruppe gehören.

Return

Line: Dieses Seitenelement zur Verkettung.

Autorisierung

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

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

bringToFront()

Bringt das Seitenelement in den Vordergrund der Seite

Das Seitenelement darf nicht zu einer Gruppe gehören.

Return

Line: Dieses Seitenelement zur Verkettung.

Autorisierung

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

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

duplicate()

Dupliziert das Seitenelement.

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

Return

PageElement: Das neue Duplikat dieses Seitenelements.

Autorisierung

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

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

getConnectionSites()

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

Return

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

Autorisierung

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

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

getDashStyle()

Ruft den DashStyle der Zeile ab.

Return

DashStyle: Der Stil der Strichlinie, die bei dieser Linie verwendet wird.

Autorisierung

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

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

getDescription()

Gibt die Alt-Textbeschreibung des Seitenelements zurück Die Beschreibung wird mit dem Titel kombiniert, um den Alt-Text anzuzeigen und zu lesen.

Return

String: Die Alt-Textbeschreibung des Seitenelements.

Autorisierung

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

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

getEnd()

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

Return

Point: Der Endpunkt der Linie.

Autorisierung

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

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

getEndArrow()

Ruft das ArrowStyle des Pfeils am Ende der Zeile ab.

Return

ArrowStyle: Der Stil des Pfeils am Ende dieser Linie.

Autorisierung

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

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

getEndConnection()

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

Return

ConnectionSite: Die Verbindung am Ende der Zeile.

Autorisierung

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

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

getHeight()

Ruft die Höhe des Elements in Punkten ab. Dies ist die Höhe des Begrenzungsrahmens des Elements, wenn das Element keine Rotation hat.

Diese Methode ist nicht mit allen Seitenelementen kompatibel. Welche Seitenelemente nicht mit dieser Methode kompatibel sind, erfahren Sie in den Einschränkungen für Größen und Positionierung.

Return

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

Autorisierung

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

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

getInherentHeight()

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

Die Transformation des Seitenelements ist relativ zu seiner inhärenten Größe. Verwenden Sie die inhärente Größe zusammen mit der Transformation des Elements, um das endgültige visuelle Erscheinungsbild des Elements zu bestimmen.

Return

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

Autorisierung

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

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

getInherentWidth()

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

Die Transformation des Seitenelements ist relativ zu seiner inhärenten Größe. Verwenden Sie die inhärente Größe zusammen mit der Transformation des Elements, um das endgültige visuelle Erscheinungsbild des Elements zu bestimmen.

Return

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

Autorisierung

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

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

getLeft()

Gibt die horizontale Position des Elements in Punkten zurück, gemessen von der linken oberen Ecke der Seite aus, wenn das Element keine Drehung aufweist.

Return

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

Autorisierung

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

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

getLineCategory()

Ruft den LineCategory der Zeile ab.

Return

LineCategory: Die Linienkategorie.

Autorisierung

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

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

getLineFill()

Ruft den LineFill der Zeile ab.

Return

LineFill: Die Fülleinstellung dieser Zeile.

Autorisierung

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

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

getLineType()

Ruft den LineType der Zeile ab.

Return

LineType: Der Linientyp.

Autorisierung

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

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

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

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

Return

Link

Autorisierung

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

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

getObjectId()

Gibt die eindeutige ID für dieses Objekt zurück Von Seiten und Seitenelementen verwendete Objekt-IDs haben denselben Namespace.

Return

String: Die eindeutige ID für dieses Objekt.

Autorisierung

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

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

getPageElementType()

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

Return

PageElementType: Der Typ des Seitenelements.

Autorisierung

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

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

getParentGroup()

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

Return

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

Autorisierung

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

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

getParentPage()

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

Return

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

Autorisierung

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

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

getRotation()

Gibt den Rotationswinkel des Elements im Uhrzeigersinn um seinen Mittelpunkt in Grad zurück, wobei null Grad keine Drehung bedeutet.

Return

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

Autorisierung

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

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

getStart()

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

Return

Point: Der Startpunkt der Linie.

Autorisierung

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

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

getStartArrow()

Ruft den ArrowStyle des Pfeils am Anfang der Zeile ab.

Return

ArrowStyle: Der Stil des Pfeils am Anfang der Linie.

Autorisierung

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

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

getStartConnection()

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

Return

ConnectionSite: Die Verbindung am Anfang der Zeile.

Autorisierung

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

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

getTitle()

Gibt den Alt-Texttitel des Seitenelements zurück Der Titel wird mit der Beschreibung kombiniert, um Alt-Text anzuzeigen und zu lesen.

Return

String: Der Alt-Texttitel des Seitenelements.

Autorisierung

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

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

getTop()

Ruft die vertikale Position des Elements in Punkten ab, gemessen von der linken oberen Ecke der Seite, wenn das Element keine Drehung aufweist.

Return

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

Autorisierung

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

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

getTransform()

Gibt die Transformation des Seitenelements zurück.

Die visuelle Darstellung des Seitenelements wird durch seine absolute Transformation bestimmt. Zum Berechnen der absoluten Transformation verketten Sie die Transformation eines Seitenelements mit den Transformationen aller übergeordneten Gruppen vor. Wenn sich das Seitenelement nicht in einer Gruppe befindet, entspricht seine absolute Transformation dem Wert in diesem Feld.

Return

AffineTransform: Die Transformation des Seitenelements.

Autorisierung

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

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

getWeight()

Gibt die Linienstärke in Punkten zurück

Return

Number: Die Stärke der Linie in Punkten.

Autorisierung

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

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

getWidth()

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

Diese Methode ist nicht mit allen Seitenelementen kompatibel. Welche Seitenelemente nicht mit dieser Methode kompatibel sind, erfahren Sie in den Einschränkungen für Größen und Positionierung.

Return

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

Autorisierung

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

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

isConnector()

Gibt true zurück, wenn die Linie eine Verbindung ist, oder false, wenn nicht.

Connector ist ein Linientyp, mit dem Verbindungswebsites auf entsprechenden Seitenelementen verbunden werden. Jedes Ende des Connectors kann mit höchstens einem Verbindungsstandort verbunden werden.

Return

Boolean: True, wenn die Linie eine Verbindung ist, oder false, wenn nicht.

Autorisierung

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

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

preconcatenateTransform(transform)

Verkettet die angegebene Transformation mit der vorhandenen Transformation des Seitenelements vor. 

newTransform = argument * existingTransform

So verschieben Sie beispielsweise ein Seitenelement um 36 Punkte nach links: 

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 auf die Transformation dieses Seitenelements vorbereitet werden soll.

Return

Line: Dieses Seitenelement zur Verkettung.

Autorisierung

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

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

remove()

Entfernt das Seitenelement.

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

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

Autorisierung

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

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

Entfernt einen Link. 

shape.removeLink();

reroute()

Der Anfang und das Ende der Linie werden auf die beiden nächstgelegenen Verbindungsstellen in den verbundenen Seitenelementen umgeleitet. Anfang und Ende der Linie müssen mit verschiedenen Seitenelementen verbunden sein.

Return

Line: Die Linie.

Autorisierung

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

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

scaleHeight(ratio)

Skaliert die Höhe des Elements um das angegebene Verhältnis. Wenn das Element nicht gedreht wird, entspricht die Höhe des Elements der Höhe des Begrenzungsrahmens.

Diese Methode ist nicht mit allen Seitenelementen kompatibel. Welche Seitenelemente nicht mit dieser Methode kompatibel sind, erfahren Sie in den Einschränkungen für Größen und Positionierung.

Parameter

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

Return

Line: Dieses Seitenelement zur Verkettung.

Autorisierung

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

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

scaleWidth(ratio)

Skaliert die Breite des Elements um das angegebene Verhältnis. Wenn das Element nicht gedreht wird, entspricht die Breite des Elements der Breite des Begrenzungsrahmens.

Diese Methode ist nicht mit allen Seitenelementen kompatibel. Welche Seitenelemente nicht mit dieser Methode kompatibel sind, erfahren Sie in den Einschränkungen für Größen und Positionierung.

Parameter

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

Return

Line: Dieses Seitenelement zur Verkettung.

Autorisierung

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

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

select()

Wählt nur das PageElement in der aktiven Präsentation aus und entfernt jede vorherige Auswahl. 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 auch nur dann, wenn das Skript an die Präsentation gebunden ist.

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

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

Autorisierung

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

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

select(replace)

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

Ein Skript kann nur auf die Auswahl des Nutzers zugreifen, der das Skript ausführt, und auch nur dann, wenn 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 das übergeordnete Element Page von PageElement als current page selection festgelegt.

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

Beim Auswählen eines Seitenelements mithilfe eines false-Parameters müssen die folgenden Bedingungen erfüllt sein:

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

Um das zu erreichen, empfiehlt es sich, zuerst das übergeordnete Page-Element mit Page.selectAsCurrentPage() auszuwählen und dann die Seitenelemente auf dieser Seite auszuwählen. 

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

Parameter

NameTypBeschreibung
replaceBooleanBei true ersetzt die Auswahl die vorherige Auswahl. Andernfalls wird die Auswahl zu einer beliebigen vorherigen Auswahl hinzugefügt.

Autorisierung

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

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

sendBackward()

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

Das Seitenelement darf nicht zu einer Gruppe gehören.

Return

Line: Dieses Seitenelement zur Verkettung.

Autorisierung

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

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

sendToBack()

Versetzt das Seitenelement an den hinteren Teil der Seite

Das Seitenelement darf nicht zu einer Gruppe gehören.

Return

Line: Dieses Seitenelement zur Verkettung.

Autorisierung

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

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

setDashStyle(style)

Legt den DashStyle der Zeile fest.

Parameter

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

Return

Line: Diese Zeile zur Verkettung.

Autorisierung

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

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

setDescription(description)

Legt die Alt-Textbeschreibung des Seitenelements fest.

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

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

Parameter

NameTypBeschreibung
descriptionStringDer String, auf den die alternative Textbeschreibung festgelegt werden soll.

Return

Line: Dieses Seitenelement.

Autorisierung

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

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

setEnd(left, top)

Legt die Position des Endpunkts der Linie fest.

Der Linienpfad kann nach einer Änderung der Position angepasst werden.

Parameter

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

Return

Line: Diese Zeile zur Verkettung.

Autorisierung

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

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

setEnd(point)

Legt die Position des Endpunkts der Linie fest.

Der Linienpfad kann nach einer Änderung der Position angepasst werden.

Parameter

NameTypBeschreibung
pointPointDer Endpunkt der Linie, deren Position von der oberen linken Ecke der Seite aus gemessen wird.

Return

Line: Diese Zeile zur Verkettung.

Autorisierung

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

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

setEndArrow(style)

Legt den ArrowStyle des Pfeils am Ende der Linie fest.

Parameter

NameTypBeschreibung
styleArrowStyleDer festzulegende Stil.

Return

Line: Diese Zeile zur Verkettung.

Autorisierung

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

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

setEndConnection(connectionSite)

Legt die Verbindung am Ende der Zeile fest. Das Ende der Linie wird zum angegebenen Verbindungsstandort verschoben, während das andere Ende intakt bleibt.

Parameter

NameTypBeschreibung
connectionSiteConnectionSiteDer Verbindungsstandort, auf den die Endverbindung aktualisiert wird, oder null, wenn die Endverbindung entfernt wird.

Return

Line: Die Linie.

Autorisierung

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

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

setHeight(height)

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

Diese Methode ist nicht mit allen Seitenelementen kompatibel. Welche Seitenelemente nicht mit dieser Methode kompatibel sind, erfahren Sie in den Einschränkungen für Größen und Positionierung.

Parameter

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

Return

Line: Dieses Seitenelement zur Verkettung.

Autorisierung

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

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

setLeft(left)

Legt die horizontale Position des Elements in Punkten fest, gemessen von der linken oberen Ecke der Seite aus, wenn das Element keine Drehung aufweist.

Parameter

NameTypBeschreibung
leftNumberDie neue festzulegende horizontale Position in Punkten.

Return

Line: Dieses Seitenelement zur Verkettung.

Autorisierung

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

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

setLineCategory(lineCategory)

Legt den LineCategory der Zeile fest.

Sie können die Kategorie nur in connectors festlegen. Der Connector kann nach einer Änderung der Kategorie neu berechnet werden.

Parameter

NameTypBeschreibung
lineCategoryLineCategoryDie festzulegende Linienkategorie.

Return

Line: Die Linie.

Autorisierung

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

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

setLinkSlide(slideIndex)

Legt ein Link auf das angegebene Slide fest, wobei der nullbasierte Index der Folie verwendet wird. 

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

Parameter

NameTypBeschreibung
slideIndexIntegerDer nullbasierte Index zur Folie.

Return

Link – die festgelegte Link

Autorisierung

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

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

setLinkSlide(slide)

Legt ein Link auf das angegebene Slide fest, der Link wird durch die angegebene Folien-ID festgelegt. 

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

Parameter

NameTypBeschreibung
slideSlideDie zu verknüpfende Slide.

Return

Link – die festgelegte Link

Autorisierung

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

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

setLinkSlide(slidePosition)

Legt ein Link auf das angegebene Slide fest, wobei die relative Position der Folie verwendet wird. 

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

Parameter

NameTypBeschreibung
slidePositionSlidePositionDie relative SlidePosition.

Return

Link – die festgelegte Link

Autorisierung

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

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

setLinkUrl(url)

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

// Set a link to the URL.
shape.setLinkUrl("https://slides.google.com");

Parameter

NameTypBeschreibung
urlStringDer URL-String.

Return

Link – die festgelegte Link

Autorisierung

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

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

setRotation(angle)

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

Diese Methode ist nicht mit allen Seitenelementen kompatibel. Welche Seitenelemente nicht mit dieser Methode kompatibel sind, erfahren Sie in den Einschränkungen für Größen und Positionierung.

Parameter

NameTypBeschreibung
angleNumberDer neue festzulegende Rotationswinkel im Uhrzeigersinn in Grad.

Return

Line: Dieses Seitenelement zur Verkettung.

Autorisierung

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

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

setStart(left, top)

Legt die Position des Startpunkts der Linie fest.

Der Linienpfad kann nach einer Änderung der Position 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.

Return

Line: Diese Zeile zur Verkettung.

Autorisierung

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

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

setStart(point)

Legt die Position des Startpunkts der Linie fest.

Der Linienpfad kann nach einer Änderung der Position angepasst werden.

Parameter

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

Return

Line: Diese Zeile zur Verkettung.

Autorisierung

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

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

setStartArrow(style)

Legt den ArrowStyle des Pfeils am Anfang der Zeile fest.

Parameter

NameTypBeschreibung
styleArrowStyleDer neu festzulegende Pfeilstil.

Return

Line: Diese Zeile zur Verkettung.

Autorisierung

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

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

setStartConnection(connectionSite)

Legt die Verbindung am Anfang der Zeile fest. Der Anfang der Linie wird zum angegebenen Verbindungsstandort verschoben, während das andere Ende intakt bleibt.

Parameter

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

Return

Line: Die Linie.

Autorisierung

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

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

setTitle(title)

Legt den Titel des Alt-Textes des Seitenelements fest.

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

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

Parameter

NameTypBeschreibung
titleStringDie Zeichenfolge, auf die der Titel des alternativen Textes festgelegt werden soll.

Return

Line: Dieses Seitenelement.

Autorisierung

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

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

setTop(top)

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

Parameter

NameTypBeschreibung
topNumberDie neue festzulegende vertikale Position in Punkten.

Return

Line: Dieses Seitenelement zur Verkettung.

Autorisierung

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

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

setTransform(transform)

Legt die Transformation des Seitenelements mit der angegebenen Transformation fest.

Wenn Sie die Transformation einer Gruppe aktualisieren, ändert sich auch die absolute Transformation der Seitenelemente in dieser Gruppe, wodurch sich auch ihre visuelle Darstellung ändert.

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 sind davon nicht betroffen.

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

Parameter

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

Return

Line: Dieses Element zur Verkettung.

Autorisierung

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

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

setWeight(points)

Legt die Linienstärke in Punkten fest.

Parameter

NameTypBeschreibung
pointsNumberDie neue Linienstärke in Punkten.

Return

Line: Diese Zeile zur Verkettung.

Autorisierung

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

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

setWidth(width)

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

Diese Methode ist nicht mit allen Seitenelementen kompatibel. Welche Seitenelemente nicht mit dieser Methode kompatibel sind, erfahren Sie in den Einschränkungen für Größen und Positionierung.

Parameter

NameTypBeschreibung
widthNumberDie neue festzulegende Breite dieses Seitenelements in Punkten.

Return

Line: Dieses Seitenelement zur Verkettung.

Autorisierung

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

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