Объектная модель JavaScript для Word в надстройках Office

  • Статья

В этой статье описаны основные концепции использования API JavaScript для Word с целью создания надстроек.

Важно!

Сведения об асинхронном типе API-интерфейсов Word и принципах их работы с документами см. в статье Использование модели API, зависящей от приложения.

API-интерфейсы Office.js для Word

Надстройка Word взаимодействует с объектами в Word с помощью API JavaScript для Office. Сюда входят две объектные модели JavaScript:

  • API JavaScript для Word. API-интерфейс JavaScript для Word предоставляет строго типизированные объекты, подходящие для документов, диапазонов, таблиц, списков, форматирования и т. д.

  • Общие API-интерфейсы. Общий API предоставляет доступ к таким компонентам, как пользовательский интерфейс, диалоговые окна и параметры клиентов, общие для разных приложений Office.

Скорее всего, вы будете разрабатывать большую часть функций надстроек для Word с помощью API JavaScript для Word, но вам также потребуются объекты из общего API. Пример.

  • Office.Context: Context объект представляет среду выполнения надстройки и предоставляет доступ к ключевым объектам API. Он состоит из данных конфигурации документа, например contentLanguage и officeTheme, а также предоставляет сведения о среде выполнения надстройки, например host и platform. Кроме того, он предоставляет requirements.isSetSupported() метод, который можно использовать для проверка, поддерживается ли указанный набор требований Word приложением, в котором выполняется надстройка.
  • Office.Document: Office.Document объект предоставляет getFileAsync() метод, который можно использовать для скачивания Word файла, в котором выполняется надстройка. Это отдельно от Word. Объект Document.

Различия между API JS для Word и общими API.

Объектная модель для Word

Чтобы понять API-интерфейсы Word, нужно понимать, как компоненты документа связаны друг с другом.

  • Объект Document содержит объекты Section, а также объекты уровня документа, например параметры и настраиваемые части XML.
  • Объект Section содержит объект Body.
  • Объект Body предоставляет доступ к объектам Paragraph, ContentControl и Range, а также к другим объектам.
  • Объект Range представляет собой непрерывную область содержимого, включающую текст, пробелы, объекты Table, а также изображения. Он также содержит большую часть методов обработки текста.
  • Объект List представляет текст в виде нумерованного или маркированного списка.

См. также