Предварительная версия 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.
| Класс | Поля | Описание |
|---|---|---|
| PlaceholderFormat | containedType | Возвращает тип фигуры, содержащейся в заполнителье. |
| type | Возвращает тип этого заполнителя. | |
| Shape | group | Возвращает объект , связанный ShapeGroup с фигурой. |
| level | Возвращает уровень указанной фигуры. | |
| parentGroup | Возвращает родительскую группу этой фигуры. | |
| заполнительFormat | Возвращает свойства, которые применяются специально к этому заполнителю. | |
| ShapeCollection | addGroup(values: строка массива<| Фигура>) | Создайте группу фигур для нескольких фигур. |
| ShapeGroup | id | Возвращает уникальный идентификатор группы фигур. |
| shape | Возвращает объект, Shape связанный с группой. |
|
| shapes | Возвращает коллекцию Shape объектов в группе. |
|
| ungroup() | Отменяет группировку любых сгруппированных фигур в указанной группе фигур. | |
| ShapeScopedCollection | group() | Группы все фигуры в этой коллекции в одну фигуру. |
| Slide | applyLayout(slideLayout: PowerPoint.SlideLayout) | Применяет указанный макет к слайду, изменяя его структуру и структуру в соответствии с выбранным макетом. |
| exportAsBase64() | Экспортирует слайд в собственный файл презентации, возвращаемый как данные в кодировке Base64. | |
| getImageAsBase64(options?: PowerPoint.SlideGetImageOptions) | Отрисовывает изображение слайда. | |
| index | Возвращает отсчитываемый от нуля индекс слайда, представляющий его позицию в презентации. | |
| moveTo(slideIndex: number) | Перемещение слайда в новую позицию в презентации. | |
| SlideGetImageOptions | height | Желаемая высота результирующего изображения в пикселях. |
| width | Желаемая ширина результирующего изображения в пикселях. | |
| SlideLayout | type | Возвращает тип макета слайда. |
См. также
Office Add-ins