Freigeben über

PowerPoint-JavaScript-Objektmodell in Office-Add-Ins

In diesem Artikel werden Konzepte beschrieben, die für die Verwendung der PowerPoint-JavaScript-API zum Erstellen von Add-Ins von grundlegender Bedeutung sind.

Office.js-APIs für PowerPoint

Ein PowerPoint-Add-In interagiert mit Objekten in PowerPoint mithilfe der Office JavaScript-API. Dies umfasst zwei JavaScript-Objektmodelle:

Während Sie wahrscheinlich die PowerPoint-JavaScript-API verwenden, um den Großteil der Funktionen in Add-Ins zu entwickeln, die auf PowerPoint ausgerichtet sind, verwenden Sie auch Objekte in der allgemeinen API. Zum Beispiel:

  • Office.Context: Das Office.Context -Objekt stellt die Laufzeitumgebung des Add-Ins dar und bietet Zugriff auf Schlüsselobjekte der API. Sie besteht aus Präsentationskonfigurationsdetails wie contentLanguage und und officeTheme stellt außerdem Informationen zur Laufzeitumgebung des Add-Ins bereit, z host . B. und platform. Darüber hinaus wird die -Methode bereitgestellt, mit der requirements.isSetSupported() Sie überprüfen können, ob ein angegebener Anforderungssatz von der PowerPoint-Anwendung unterstützt wird, in der das Add-In ausgeführt wird.
  • Office.Document: Das Office.Document -Objekt stellt die getFileAsync() -Methode bereit, mit der Sie die PowerPoint-Datei herunterladen können, in der das Add-In ausgeführt wird. Außerdem wird die getActiveViewAsync() -Methode bereitgestellt, mit der Sie überprüfen können, ob sich die Präsentation in einer "Lesen"- oder "Bearbeiten"-Ansicht befindet. "Bearbeiten" entspricht einer der Ansichten, in denen Sie Folien bearbeiten können: Normal, Foliensortierung oder Gliederungsansicht. "lesen" entspricht entweder der Bildschirmpräsentation oder der Leseansicht.

PowerPoint-spezifisches Objektmodell

Um die PowerPoint-APIs zu verstehen, müssen Sie wissen, wie wichtige Komponenten einer Präsentation miteinander zusammenhängen.

  • Die Präsentation enthält Folien und Entitäten auf Präsentationsebene, z. B. Einstellungen und benutzerdefinierte XML-Teile.
  • Eine Folie enthält Inhalte wie Formen, Text und Tabellen.
  • Ein Layout bestimmt, wie der Inhalt einer Folie organisiert und angezeigt wird.

Den vollständigen Satz von Objekten, die von der PowerPoint JavaScript-API unterstützt werden, finden Sie unter PowerPoint JavaScript-API.

Siehe auch