Ein PageElement
, das eine Tabelle darstellt.
Methoden
Methode | Rückgabetyp | Kurzbeschreibung |
---|---|---|
alignOnPage(alignmentPosition) | Table | Richtet das Element an der angegebenen Position auf der Seite aus. |
appendColumn() | TableColumn | Hängt rechts neben der letzten Spalte der Tabelle eine neue Spalte an. |
appendRow() | TableRow | Hängt unter der letzten Zeile der Tabelle eine neue Zeile an. |
bringForward() | Table | Bringt das Seitenelement auf der Seite um ein Element nach vorn |
bringToFront() | Table | Bringt das Seitenelement in den Vordergrund der Seite |
duplicate() | PageElement | Dupliziert das Seitenelement. |
getCell(rowIndex, columnIndex) | TableCell | Gibt die angegebene Zelle in der Tabelle zurück. |
getColumn(columnIndex) | TableColumn | Gibt die angegebene Spalte in der Tabelle zurück. |
getConnectionSites() | ConnectionSite[] | Gibt die Liste der ConnectionSite s für das Seitenelement oder eine leere Liste zurück, wenn das Seitenelement keine Verbindungswebsites hat. |
getDescription() | String | Gibt die Alt-Textbeschreibung des Seitenelements zurück |
getHeight() | Number | Ruft die Höhe des Elements in Punkten ab. Dies ist die Höhe des Begrenzungsrahmens des Elements, wenn das Element keine Rotation hat. |
getInherentHeight() | Number | Gibt die inhärente Höhe des Elements in Punkten zurück |
getInherentWidth() | Number | Gibt die inhärente 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 aus, wenn das Element keine Drehung aufweist. |
getNumColumns() | Integer | Gibt die Anzahl der Spalten in der Tabelle zurück. |
getNumRows() | Integer | Gibt die Anzahl der Zeilen in der Tabelle zurück. |
getObjectId() | String | Gibt die eindeutige ID für dieses Objekt zurück |
getPageElementType() | PageElementType | Gibt den Typ des Seitenelements zurück, dargestellt als PageElementType -Enum. |
getParentGroup() | Group | Gibt die Gruppe zurück, zu der dieses Seitenelement gehört, oder null , wenn das Element nicht zu einer Gruppe gehört |
getParentPage() | Page | Gibt die Seite zurück, auf der sich das Seitenelement befindet |
getRotation() | Number | Gibt den Rotationswinkel des Elements im Uhrzeigersinn um seinen Mittelpunkt in Grad zurück, wobei null Grad keine Drehung bedeutet. |
getRow(rowIndex) | TableRow | Gibt die angegebene Zeile in der Tabelle zurück. |
getTitle() | String | Gibt den Alt-Texttitel des Seitenelements zurück |
getTop() | Number | Ruft die vertikale Position des Elements in Punkten ab, gemessen von der linken oberen Ecke der Seite, wenn das Element keine Drehung aufweist. |
getTransform() | AffineTransform | Gibt die Transformation des Seitenelements zurück. |
getWidth() | Number | Gibt die Breite des Elements in Punkten zurück. Das ist die Breite des Begrenzungsrahmens des Elements, wenn das Element nicht gedreht wird. |
insertColumn(index) | TableColumn | Fügt beim angegebenen Index der Tabelle eine neue Spalte ein. |
insertRow(index) | TableRow | Fügt beim angegebenen Index der Tabelle eine neue Zeile ein. |
preconcatenateTransform(transform) | Table | Verkettet die angegebene Transformation mit der vorhandenen Transformation des Seitenelements vor. |
remove() | void | Entfernt das Seitenelement. |
scaleHeight(ratio) | Table | Skaliert die Höhe des Elements um das angegebene Verhältnis. |
scaleWidth(ratio) | Table | Skaliert die Breite des Elements um das angegebene Verhältnis. |
select() | void | Wählt nur das PageElement in der aktiven Präsentation aus und entfernt jede vorherige Auswahl. |
select(replace) | void | Wählt das PageElement in der aktiven Präsentation aus. |
sendBackward() | Table | Versetzt das Seitenelement auf der Seite um ein Element nach hinten. |
sendToBack() | Table | Versetzt das Seitenelement an den hinteren Teil der Seite |
setDescription(description) | Table | Legt die Alt-Textbeschreibung des Seitenelements fest. |
setHeight(height) | Table | Legt 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) | Table | Legt die horizontale Position des Elements in Punkten fest, gemessen von der linken oberen Ecke der Seite aus, wenn das Element keine Drehung aufweist. |
setRotation(angle) | Table | Legt den Rotationswinkel des Elements im Uhrzeigersinn um seinen Mittelpunkt in Grad fest. |
setTitle(title) | Table | Legt den Titel des Alt-Textes des Seitenelements fest. |
setTop(top) | Table | Legt 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) | Table | Legt die Transformation des Seitenelements mit der angegebenen Transformation fest. |
setWidth(width) | Table | Legt 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
Name | Typ | Beschreibung |
---|---|---|
alignmentPosition | AlignmentPosition | Die Position, an der dieses Seitenelement auf der Seite ausgerichtet werden soll. |
Return
Table
: Dieses Seitenelement zur Verkettung.
appendColumn()
Hängt rechts neben der letzten Spalte der Tabelle eine neue Spalte an.
Return
TableColumn
: Die neue angehängte Spalte.
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
appendRow()
Hängt unter der letzten Zeile der Tabelle eine neue Zeile an.
Return
TableRow
: Die neu angehängte 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
bringForward()
Bringt das Seitenelement auf der Seite um ein Element nach vorn
Das Seitenelement darf nicht zu einer Gruppe gehören.
Return
Table
: 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
Table
: 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
getCell(rowIndex, columnIndex)
Gibt die angegebene Zelle in der Tabelle zurück.
Parameter
Name | Typ | Beschreibung |
---|---|---|
rowIndex | Integer | Der Zeilenindex der abzurufenden Zelle. |
columnIndex | Integer | Der Spaltenindex der abzurufenden Zelle. |
Return
TableCell
: Die abgerufene Tabellenzelle.
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
getColumn(columnIndex)
Gibt die angegebene Spalte in der Tabelle zurück.
Parameter
Name | Typ | Beschreibung |
---|---|---|
columnIndex | Integer | Der 0-basierte Spaltenindex. |
Return
TableColumn
: Die abgerufene Tabellenspalte.
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 ConnectionSite
s 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
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
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
getNumColumns()
Gibt die Anzahl der Spalten in der Tabelle zurück.
Return
Integer
: Die Anzahl der Spalten in dieser Tabelle.
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getNumRows()
Gibt die Anzahl der Zeilen in der Tabelle zurück.
Return
Integer
: Die Anzahl der Zeilen in dieser Tabelle.
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
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
getRow(rowIndex)
Gibt die angegebene Zeile in der Tabelle zurück.
Parameter
Name | Typ | Beschreibung |
---|---|---|
rowIndex | Integer | Der Index der abzurufenden Zeile. |
Return
TableRow
: Die abgerufene Tabellenzeile.
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
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
insertColumn(index)
Fügt beim angegebenen Index der Tabelle eine neue Spalte ein.
Wenn alle Zellen in der Spalte links vom angegebenen Index mit anderen Spalten zusammengeführt werden, wird die neue Spalte rechts neben den gemeinsamen Spalten, die von diesen Zellen abgedeckt werden, eingefügt.
Parameter
Name | Typ | Beschreibung |
---|---|---|
index | Integer | Der Index, an dem eine neue Spalte eingefügt werden soll. |
Return
TableColumn
: Die neue eingefügte Spalte.
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
insertRow(index)
Fügt beim angegebenen Index der Tabelle eine neue Zeile ein.
Wenn alle Zellen in der Zeile über dem angegebenen Index mit anderen Zeilen zusammengeführt werden, wird die neue Zeile unterhalb der gemeinsamen Zeilen eingefügt, die sich über diese Zellen erstrecken.
Parameter
Name | Typ | Beschreibung |
---|---|---|
index | Integer | Der Index, an dem eine neue Zeile eingefügt werden soll. |
Return
TableRow
: Die neu eingefügte Zeile.
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
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
Name | Typ | Beschreibung |
---|---|---|
transform | AffineTransform | Die Transformation, die auf die Transformation dieses Seitenelements vorbereitet werden soll. |
Return
Table
: 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
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
Name | Typ | Beschreibung |
---|---|---|
ratio | Number | Das Seitenverhältnis, um das die Höhe dieses Seitenelements skaliert werden soll. |
Return
Table
: 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
Name | Typ | Beschreibung |
---|---|---|
ratio | Number | Das Seitenverhältnis, um das die Breite dieses Seitenelements skaliert werden soll. |
Return
Table
: 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:
- Die übergeordnete
Page
desPageElement
-Objekts musscurrent page selection
sein. - 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
Name | Typ | Beschreibung |
---|---|---|
replace | Boolean | Bei 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
Table
: 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
Table
: 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
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
Name | Typ | Beschreibung |
---|---|---|
description | String | Der String, auf den die alternative Textbeschreibung festgelegt werden soll. |
Return
Table
: 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
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
Name | Typ | Beschreibung |
---|---|---|
height | Number | Die neue festzulegende Höhe dieses Seitenelements in Punkten. |
Return
Table
: 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
Name | Typ | Beschreibung |
---|---|---|
left | Number | Die neue festzulegende horizontale Position in Punkten. |
Return
Table
: 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
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
Name | Typ | Beschreibung |
---|---|---|
angle | Number | Der neue festzulegende Rotationswinkel im Uhrzeigersinn in Grad. |
Return
Table
: 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
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
Name | Typ | Beschreibung |
---|---|---|
title | String | Die Zeichenfolge, auf die der Titel des alternativen Textes festgelegt werden soll. |
Return
Table
: 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
Name | Typ | Beschreibung |
---|---|---|
top | Number | Die neue festzulegende vertikale Position in Punkten. |
Return
Table
: 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
Name | Typ | Beschreibung |
---|---|---|
transform | AffineTransform | Die Transformation, die für dieses Seitenelement festgelegt wird. |
Return
Table
: 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
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
Name | Typ | Beschreibung |
---|---|---|
width | Number | Die neue festzulegende Breite dieses Seitenelements in Punkten. |
Return
Table
: 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