Diese Seite wurde von der Cloud Translation API übersetzt.

Class SlidesApp

Erstellt und öffnet Presentations, das bearbeitet werden kann.

// Open a presentation by ID.
let preso = SlidesApp.openById('PRESENTATION_ID_GOES_HERE');

// Create and open a presentation.
preso = SlidesApp.create('Presentation Name');

Attribute

Attribut	Typ	Beschreibung
`AlignmentPosition`	`AlignmentPosition`	Eine Aufzählung der Arten von Ausrichtungspositionen.
`ArrowStyle`	`ArrowStyle`	Eine Aufzählung der verschiedenen Pfeilstile, die ein `Line` haben kann.
`AutoTextType`	`AutoTextType`	Eine Aufzählung der Arten von automatischen Texten.
`AutofitType`	`AutofitType`	Eine Aufzählung der automatischen Anpassungstypen.
`CellMergeState`	`CellMergeState`	Eine Aufzählung der verschiedenen Zusammenführungsstatus einer Tabellenzelle.
`ColorType`	`ColorType`	Eine Aufzählung von Farbtypen.
`ContentAlignment`	`ContentAlignment`	Eine Aufzählung von Werten, mit denen die Textausrichtung angegeben wird.
`DashStyle`	`DashStyle`	Eine Aufzählung der verschiedenen Strichstile, die ein `Line` haben kann.
`FillType`	`FillType`	Eine Aufzählung der Füllungstypen.
`LineCategory`	`LineCategory`	Eine Aufzählung der Kategorien von `Line`.
`LineFillType`	`LineFillType`	Eine Aufzählung der `LineFill`-Typen.
`LineType`	`LineType`	Eine Aufzählung der `Line`-Typen.
`LinkType`	`LinkType`	Eine Aufzählung der Linktypen.
`ListPreset`	`ListPreset`	Eine Aufzählung der Arten von Listenvorlagen.
`PageBackgroundType`	`PageBackgroundType`	Eine Aufzählung der Arten von Seitenhintergründen.
`PageElementType`	`PageElementType`	Eine Aufzählung der Arten von Seitenelementen.
`PageType`	`PageType`	Eine Aufzählung der Seitentypen.
`ParagraphAlignment`	`ParagraphAlignment`	Eine Aufzählung der Arten der Absatzausrichtung.
`PlaceholderType`	`PlaceholderType`	Eine Aufzählung der Platzhaltertypen.
`PredefinedLayout`	`PredefinedLayout`	Eine Aufzählung der vordefinierten Layouts.
`SelectionType`	`SelectionType`	Eine Aufzählung der Auswahltypen.
`ShapeType`	`ShapeType`	Eine Aufzählung der Formen.
`SheetsChartEmbedType`	`SheetsChartEmbedType`	Eine Aufzählung der Einbettungstypen für Google Tabellen-Diagramme.
`SlideLinkingMode`	`SlideLinkingMode`	Aufzählung der Möglichkeiten, wie Präsentationen verknüpft werden können.
`SlidePosition`	`SlidePosition`	Eine Aufzählung der Folienpositionen.
`SpacingMode`	`SpacingMode`	Aufzählung der Arten von Abstandsmodi.
`TextBaselineOffset`	`TextBaselineOffset`	Eine Aufzählung der Arten von Textgrundlinienabständen.
`TextDirection`	`TextDirection`	Eine Aufzählung der Arten von Textwegbeschreibungen.
`ThemeColorType`	`ThemeColorType`	Eine Aufzählung von Designfarben.
`VideoSourceType`	`VideoSourceType`	Eine Aufzählung der Videoquellentypen.

Methoden

Methode	Rückgabetyp	Kurzbeschreibung
`create(name)`	`Presentation`	Erstellt und öffnet eine neue `Presentation`.
`getActivePresentation()`	`Presentation`	Gibt die aktuell aktive Präsentation zurück, an die das Script containergebunden ist, oder `null`, wenn keine aktive Präsentation vorhanden ist.
`getUi()`	`Ui`	Gibt eine Instanz der Benutzeroberfläche der Präsentation zurück, mit der dem Script Funktionen wie Menüs, Dialogfelder und Seitenleisten hinzugefügt werden können.
`newAffineTransformBuilder()`	`AffineTransformBuilder`	Gibt eine neue `AffineTransformBuilder` zurück, um eine `AffineTransform` zu erstellen.
`openById(id)`	`Presentation`	Öffnet die `Presentation` mit der angegebenen ID.
`openByUrl(url)`	`Presentation`	Öffnet `Presentation` mit der angegebenen URL.

Detaillierte Dokumentation

`create(name)`

Erstellt und öffnet eine neue Presentation.

Parameter

Name	Typ	Beschreibung
`name`	`String`	Der Name, der der erstellten Präsentation gegeben werden soll.

Rückflug

Presentation – die Präsentation mit dem angegebenen Namen.

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

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

`getActivePresentation()`

Gibt die aktuell aktive Präsentation zurück, an die das Script containergebunden ist, oder null, wenn keine aktive Präsentation vorhanden ist. Wenn Sie mit einer Präsentation interagieren möchten, die nicht containergebunden ist, verwenden Sie stattdessen openById(id).

// Get the current presentation to which this script is bound.
const presentation = SlidesApp.getActivePresentation();

Wenn die Präsentation bereits geöffnet ist, wird dieselbe Präsentations-Instanz zurückgegeben.

Rückflug

Presentation

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

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

`getUi()`

Gibt eine Instanz der Benutzeroberfläche der Präsentation zurück, mit der dem Script Funktionen wie Menüs, Dialogfelder und Seitenleisten hinzugefügt werden können. Ein Script kann nur mit der Benutzeroberfläche der aktuellen Instanz einer geöffneten Präsentation interagieren und nur dann, wenn das Script mit der Präsentation gebunden ist. Weitere Informationen finden Sie in den Anleitungen zu Menüs und Dialogfeldern und Seitenleisten.

// Add a custom menu to the active presentation, including a separator and a
// sub-menu.
function onOpen(e) {
  SlidesApp.getUi()
      .createMenu('My Menu')
      .addItem('My menu item', 'myFunction')
      .addSeparator()
      .addSubMenu(
          SlidesApp.getUi()
              .createMenu('My sub-menu')
              .addItem('One sub-menu item', 'mySecondFunction')
              .addItem('Another sub-menu item', 'myThirdFunction'),
          )
      .addToUi();
}

Rückflug

Ui

`newAffineTransformBuilder()`

Gibt eine neue AffineTransformBuilder zurück, um eine AffineTransform zu erstellen. Der Builder ist mit der Identitätsaffinen Transformation vorkonfiguriert.

Rückflug

AffineTransformBuilder

`openById(id)`

Öffnet die Presentation mit der angegebenen ID.

// Open a presentation by ID.
const presentation = SlidesApp.openById('docId');

Wenn die Präsentation bereits geöffnet ist, wird dieselbe Präsentations-Instanz zurückgegeben.

Parameter

Name	Typ	Beschreibung
`id`	`String`

Rückflug

Presentation – die Präsentation mit der angegebenen ID

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

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

`openByUrl(url)`

Öffnet Presentation mit der angegebenen URL.

// Open a presentation by URL.
const presentation = SlidesApp.openByUrl(
    'https://docs.google.com/presentation/d/docId/edit',
);

Wenn die Präsentation bereits geöffnet ist, wird dieselbe Präsentations-Instanz zurückgegeben.

Parameter

Name	Typ	Beschreibung
`url`	`String`

Rückflug

Presentation – die Präsentation mit der angegebenen URL

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

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