Class SlidesApp

Google PräsentationenApp

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

AttributTypBeschreibung
AlignmentPositionAlignmentPositionEine Aufzählung der Arten von Ausrichtungspositionen.
ArrowStyleArrowStyleEine Aufzählung der verschiedenen Pfeilstile, die ein Line haben kann.
AutoTextTypeAutoTextTypeEine Aufzählung der Arten von Auto-Text.
AutofitTypeAutofitTypeEine Aufzählung der Typen für das automatische Anpassen.
CellMergeStateCellMergeStateEine Aufzählung der verschiedenen Zusammenführungsstatus einer Tabellenzelle.
ColorTypeColorTypeEine Aufzählung von Farbtypen.
ContentAlignmentContentAlignmentEine Aufzählung von Werten, mit denen die Ausrichtung von Inhalten angegeben wird.
DashStyleDashStyleEine Aufzählung der verschiedenen Strichstile, die ein Line haben kann.
FillTypeFillTypeEine Aufzählung von Fülltypen.
LineCategoryLineCategoryEine Aufzählung der Kategorien von Line.
LineFillTypeLineFillTypeEine Aufzählung der Typen von LineFill.
LineTypeLineTypeEine Aufzählung der Typen von Line.
LinkTypeLinkTypeEine Aufzählung der Linktypen.
ListPresetListPresetEine Aufzählung der Arten von Listenvoreinstellungen.
PageBackgroundTypePageBackgroundTypeEine Aufzählung der Arten von Seitenhintergründen.
PageElementTypePageElementTypeEine Aufzählung der Arten von Seitenelementen.
PageTypePageTypeEine Aufzählung der Seitentypen.
ParagraphAlignmentParagraphAlignmentEine Aufzählung der Arten der Absatzausrichtung.
PlaceholderTypePlaceholderTypeEine Aufzählung der Platzhaltertypen.
PredefinedLayoutPredefinedLayoutEine Aufzählung der vordefinierten Layouts.
SelectionTypeSelectionTypeEine Aufzählung der Auswahltypen.
ShapeTypeShapeTypeEine Aufzählung der Formtypen.
SheetsChartEmbedTypeSheetsChartEmbedTypeEine Aufzählung der Einbettungstypen für Google-Tabellen-Diagramme.
SlideLinkingModeSlideLinkingModeEine Aufzählung der Möglichkeiten, Google-Präsentationen zu verknüpfen.
SlidePositionSlidePositionEine Aufzählung der Arten von Folienpositionen.
SpacingModeSpacingModeEine Aufzählung der Arten von Abstandsmodi.
TextBaselineOffsetTextBaselineOffsetEine Aufzählung der Arten von Text-Baseline-Versatz.
TextDirectionTextDirectionEine Aufzählung der Arten von Textanweisungen.
ThemeColorTypeThemeColorTypeEine Aufzählung von Designfarben.
VideoSourceTypeVideoSourceTypeEine Aufzählung der Arten von Videoquellen.

Methoden

MethodeRückgabetypKurzbeschreibung
create(name)PresentationErstellt und öffnet ein neues Presentation.
getActivePresentation()Presentation|nullGibt die aktuell aktive Präsentation zurück, an die das Script containergebunden ist, oder null, wenn keine aktive Präsentation vorhanden ist.
getUi()UiGibt eine Instanz der Benutzeroberflächenumgebung der Präsentation zurück, mit der dem Skript Funktionen wie Menüs, Dialogfelder und Seitenleisten hinzugefügt werden können.
newAffineTransformBuilder()AffineTransformBuilderGibt ein neues AffineTransformBuilder zurück, um ein AffineTransform zu erstellen.
openById(id)PresentationÖffnet das Presentation mit der angegebenen ID.
openByUrl(url)PresentationÖffnet Presentation mit der angegebenen URL.

Detaillierte Dokumentation

create(name)

Erstellt und öffnet ein neues Presentation.

Parameter

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

  • 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, an die das Skript nicht gebunden 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äsentationsinstanz zurückgegeben.

Rückflug

Presentation|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

getUi()

Gibt eine Instanz der Benutzeroberflächenumgebung der Präsentation zurück, mit der dem Skript Funktionen wie Menüs, Dialogfelder und Seitenleisten hinzugefügt werden können. Ein Skript kann nur mit der Benutzeroberfläche der aktuellen Instanz einer geöffneten Präsentation interagieren und nur, wenn das Skript an die 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 ein neues AffineTransformBuilder zurück, um ein AffineTransform zu erstellen. Für den Builder ist die affine Identitätstransformation voreingestellt.

Rückflug

AffineTransformBuilder


openById(id)

Öffnet das 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äsentationsinstanz zurückgegeben.

Parameter

NameTypBeschreibung
idString

Rückflug

Presentation – die Präsentation mit der angegebenen ID

Autorisierung

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

  • 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äsentationsinstanz zurückgegeben.

Parameter

NameTypBeschreibung
urlString

Rückflug

Presentation – die Präsentation mit der angegebenen URL

Autorisierung

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

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