PowerPoint-JavaScript-Objektmodell in Office-Add-Ins

Mit der PowerPoint-JavaScript-API kann Ihr Add-In Präsentationen, Folien, Formen, Text und Tabellen lesen und ändern. In diesem Artikel werden die Objektmodelle, mit denen Sie arbeiten, und die wichtigsten Objekte vorgestellt, die Sie zum Erstellen von PowerPoint-Add-Ins verwenden.

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.

In der folgenden Tabelle sind wichtige Objekte in der PowerPoint-JavaScript-API aufgeführt.

Objekt Beschreibung
Presentation Das Objekt der obersten Ebene. Ermöglicht den Zugriff auf Folien, Tags und präsentationsweite Einstellungen.
Slide Eine einzelne Folie. Enthält Shapes und verweist auf das Layout.
SlideCollection Die Auflistung der Folien in der Präsentation.
Shape Eine Form auf einer Folie, z. B. ein Textfeld, ein Bild, eine Linie oder eine geometrische Form.
TextRange Der Text innerhalb einer Form. Verwenden Sie es zum Lesen und Bearbeiten von Text.
SlideLayout Das Layout, das bestimmt, wie der Inhalt einer Folie angeordnet wird.
SlideMaster Die master, die die Standardformatierung und die verfügbaren Layouts definiert.

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

Siehe auch

  • Last updated on