Word-JavaScript-Objektmodell in Office-Add-Ins

  • Artikel

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

Wichtig

Informationen zum asynchronen Charakter der Word-APIs und ihrer Funktionsweise mit dem Dokument finden Sie unter Verwenden des anwendungsspezifischen API-Modells.

Office.js-APIs für Word

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

  • Word JavaScript API: Die Word JavaScript API stellt stark typisierte Objekte bereit, die mit dem Dokument, Bereichen, Tabellen, Listen, Formatierungen und mehr funktionieren.

  • Gemeinsame APIs: Die gemeinsame API ermöglicht den Zugriff auf Features wie Benutzeroberfläche, Dialogfelder und Clienteinstellungen, die in mehreren Office-Anwendungen verwendet werden.

Während Sie wahrscheinlich die Word-JavaScript-API verwenden, um die meisten Funktionen für Add-Ins für Word zu entwickeln, verwenden Sie in der allgemeinen API auch Objekte. Beispiel:

  • Office.Context: Das Context -Objekt stellt die Laufzeitumgebung des Add-Ins dar und bietet Zugriff auf Schlüsselobjekte der API. Es besteht aus den Konfigurationsdetails der des Dokuments, wie z. B. contentLanguage und officeTheme, und bietet auch Informationen über die Laufzeitumgebung des Add-Ins, wie z. B. host und platform. Darüber hinaus wird die -Methode bereitgestellt, mit der requirements.isSetSupported() Sie überprüfen können, ob ein angegebener Anforderungssatz von der Word 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 Word-Datei herunterladen können, in der das Add-In ausgeführt wird. Dies ist vom Word getrennt. Document-Objekt.

Unterschiede zwischen der Word-JS-API und allgemeinen APIs.

Word-spezifisches Objektmodell

Um die Word-APIs zu verstehen, müssen Sie wissen, wie die Komponenten eines Dokuments miteinander verknüpft sind.

  • Das Dokument enthält die Abschnitte und Entitäten auf Dokumentebene, z. B. Einstellungen und benutzerdefinierte XML-Komponenten.
  • Ein Abschnitt enthält einen Textkörper.
  • Ein Textkörper ermöglicht u. a. den Zugriff auf Absätze, Inhaltskontrollen und Bereichsobjekte.
  • Ein Bereich stellt eine zusammenhängende Menge von Inhalten dar. Dazu zählen Text, Leerzeichen, Tabellen und Bilder. Er enthält außerdem die meisten Textbearbeitungsmethoden.
  • Eine Liste umfasst Text in einer durch Nummerierung oder Aufzählung strukturierten Liste.

Siehe auch