Предварительная версия API JavaScript для PowerPoint
Новые API JavaScript для PowerPoint сначала появляются в предварительной версии, а затем становятся частью определенного нумерованного набора требований после достаточного тестирования и получения отзывов пользователей.
Примечание.
API предварительной версии могут быть изменены и не предназначены для использования в рабочей среде. Рекомендуется использовать их только в тестовой среде и среде разработки. Не используйте API предварительной версии в рабочей среде или в важных деловых документах.
Чтобы использовать API предварительной версии:
- Необходимо использовать предварительную версию библиотеки API JavaScript для Office из сети доставки содержимого (CDN)Office.js.
Файл определения типа для компиляции TypeScript и IntelliSense находится в сети CDN и имеет тип DefinitelyTyped. Эти типы можно установить с
npm install --save-dev @types/office-js-previewпомощью (не забудьте удалить типы для@types/office-js, если они были установлены ранее). - Возможно, вам потребуется присоединиться к программе предварительной оценки Microsoft 365 для доступа к более поздним сборкам Office.
Список API
В следующей таблице перечислены API JavaScript для PowerPoint, которые в настоящее время находятся в предварительной версии. Полный список всех API JavaScript для PowerPoint (включая предварительные версии API и ранее выпущенные API) см. в разделе Все API JavaScript для PowerPoint.
| Класс | Поля | Описание |
|---|---|---|
| CustomProperty | delete() | Удаляет настраиваемое свойство. |
| key | Строка, однозначно идентифицирующая пользовательское свойство. | |
| type | Тип значения, используемого для настраиваемого свойства. | |
| value | Значение настраиваемого свойства. | |
| CustomPropertyCollection | add(key: string, value: boolean | Дата | number | string) | Создает новый CustomProperty объект или обновляет свойство с заданным ключом. |
| deleteAll() | Удаляет все настраиваемые свойства в коллекции. | |
| getCount() | Возвращает количество настраиваемых свойств в коллекции. | |
| getItem(key: string) | Получает по ключу CustomProperty . |
|
| getItemOrNullObject(key: string) | Получает по ключу CustomProperty . |
|
| items | Получает загруженные дочерние элементы в этой коллекции. | |
| CustomXmlPart | delete() | Удаляет пользовательскую XML-часть. |
| getXml() | Возвращает XML-содержимое пользовательской XML-части. | |
| id | Идентификатор настраиваемой ЧАСТИ XML. | |
| namespaceUri | URI пространства имен пользовательской XML-части. | |
| setXml(xml: string) | Задает XML-содержимое для настраиваемой части XML. | |
| CustomXmlPartCollection | add(xml: string) | Добавляет новый CustomXmlPart объект в коллекцию. |
| getByNamespace(namespaceUri: string) | Получает новую ограниченную коллекцию пользовательских XML-частей, пространства имен которых совпадают с указанным пространством имен. | |
| getCount() | Возвращает количество настраиваемых XML-частей в коллекции. | |
| getItem(id: string) | Возвращает объект на основе его идентификатора CustomXmlPart . |
|
| getItemOrNullObject(id: строка) | Возвращает объект на основе его идентификатора CustomXmlPart . |
|
| items | Получает загруженные дочерние элементы в этой коллекции. | |
| CustomXmlPartScopedCollection | getCount() | Возвращает количество настраиваемых XML-частей в этой коллекции. |
| getItem(id: string) | Возвращает объект на основе его идентификатора CustomXmlPart . |
|
| getItemOrNullObject(id: строка) | Возвращает объект на основе его идентификатора CustomXmlPart . |
|
| getOnlyItem() | Если коллекция содержит ровно один элемент, этот метод возвращает его. | |
| getOnlyItemOrNullObject() | Если коллекция содержит ровно один элемент, этот метод возвращает его. | |
| items | Получает загруженные дочерние элементы в этой коллекции. | |
| DocumentProperties | автор | Автор презентации. |
| категория | Категория презентации. | |
| comments | Поле Примечания в метаданных презентации. | |
| company | Компания презентации. | |
| creationDate | Дата создания презентации. | |
| customProperties | Коллекция настраиваемых свойств презентации. | |
| Ключевые слова | Ключевые слова презентации. | |
| lastAuthor | Последний автор презентации. | |
| manager | Руководитель презентации. | |
| revisionNumber | Номер редакции презентации. | |
| subject | Тема презентации. | |
| заголовок | Название презентации. | |
| Presentation | customXmlParts | Возвращает коллекцию настраиваемых XML-частей, связанных с презентацией. |
| properties | Возвращает свойства презентации. | |
| Shape | customXmlParts | Возвращает коллекцию настраиваемых XML-частей в фигуре. |
| type | Возвращает тип фигуры. | |
| Slide | customXmlParts | Возвращает коллекцию настраиваемых XML-частей на слайде. |
| exportAsBase64() | Экспортирует слайд в собственный файл презентации, возвращаемый как данные в кодировке Base64. | |
| getImageAsBase64(options?: PowerPoint.SlideGetImageOptions) | Отрисовывает изображение слайда. | |
| SlideGetImageOptions | height | Желаемая высота результирующего изображения в пикселях. |
| width | Желаемая ширина результирующего изображения в пикселях. | |
| SlideLayout | customXmlParts | Возвращает коллекцию настраиваемых XML-частей в макете слайда. |
| SlideMaster | customXmlParts | Возвращает коллекцию настраиваемых XML-частей в образце слайдов. |
См. также
Совместная работа с нами на GitHub
Источник этого содержимого можно найти на GitHub, где также можно создавать и просматривать проблемы и запросы на вытягивание. Дополнительные сведения см. в нашем руководстве для участников.
Office Add-ins