Примечание
Для доступа к этой странице требуется авторизация. Вы можете попробовать войти или изменить каталоги.
Для доступа к этой странице требуется авторизация. Вы можете попробовать изменить каталоги.
В этой статье описываются основные принципы использования API JavaScript в PowerPoint для создания надстроек.
API Office.js для PowerPoint
Надстройка PowerPoint взаимодействует с объектами в PowerPoint с помощью API JavaScript для Office. Сюда входят две объектные модели JavaScript:
API JavaScript Для PowerPoint. API JavaScript для PowerPoint предоставляет строго типизированные объекты, которые работают с презентацией, слайдами, таблицами, фигурами, форматированием и т. д. Сведения об асинхронном характере API PowerPoint и их работе с презентацией см. в статье Использование модели API для конкретного приложения.
Общие API-интерфейсы. Общий API предоставляет доступ к таким компонентам, как пользовательский интерфейс, диалоговые окна и параметры клиентов, общие для разных приложений Office. Дополнительные сведения об использовании общего API см. в статье Общая объектная модель API JavaScript.
Хотя вы, скорее всего, будете использовать API JavaScript в PowerPoint для разработки большинства функций надстроек, предназначенных для PowerPoint, вы также будете использовать объекты в Common API. Например:
-
Office.Context:
Office.Context
объект представляет среду выполнения надстройки и предоставляет доступ к ключевым объектам API. Он состоит из сведений о конфигурации презентации, таких какcontentLanguage
иofficeTheme
, а также предоставляет сведения о среде выполнения надстройки, такие какhost
иplatform
. Кроме того, он предоставляетrequirements.isSetSupported()
метод, который можно использовать для проверка, поддерживается ли указанный набор требований приложением PowerPoint, в котором выполняется надстройка. -
Office.Document:
Office.Document
объект предоставляетgetFileAsync()
метод, который можно использовать для скачивания файла PowerPoint, в котором выполняется надстройка. Он также предоставляетgetActiveViewAsync()
метод, который можно использовать для проверка, находится ли презентация в режиме чтения или редактирования. "изменить" соответствует любому из представлений, в которых можно редактировать слайды: Обычный, Сортировщик слайдов или Режим структуры. "чтение" соответствует слайд-шоу или режиму чтения.
Объектная модель PowerPoint
Чтобы понять API PowerPoint, необходимо понять, как ключевые компоненты презентации связаны друг с другом.
- Презентация содержит слайды и сущности уровня презентации, такие как параметры и настраиваемые XML-части.
- Слайд содержит такое содержимое, как фигуры, текст и таблицы.
- Макет определяет порядок упорядочения и отображения содержимого слайда.
Полный набор объектов, поддерживаемых API JavaScript в PowerPoint, см. в разделе API JavaScript для PowerPoint.
См. также
Office Add-ins