Наборы обязательных элементов API JavaScript для PowerPoint

Наборы требований — это именованные группы элементов API. Надстройки Office с помощью наборов обязательных элементов, указанных в манифесте, или проверки в среде выполнения определяют, поддерживает ли клиентское приложение Office необходимые API. Дополнительные сведения см. в статье Версии и наборы требований Office.

В следующей таблице перечислены наборы требований PowerPoint, поддерживаемые клиентские приложения Office, а также минимальные сборки или версии для этих приложений, где это применимо.

Набор обязательных элементов Office в Интернете Office для Windows
  • Подписка на Microsoft 365
  • Розничная бессрочная лицензия
Office для Windows
  • — бессрочная лицензия по корпоративной лицензии/LTSC
Office для Mac Office для iPad
Предварительный просмотр Используйте последнюю версию Office, чтобы попробовать предварительные версии API (вам может потребоваться присоединиться к программе предварительной оценки Microsoft 365).
PowerPointApi 1.10 Поддерживается Версия 2601 (сборка 19610.20002) Недоступно Версия 16.105 (25121030) Недоступно
PowerPointApi 1.9 Поддерживается Версия 2508 (сборка 19127.20154) Недоступно Версия 16.100 (25082415) Недоступно
PowerPointApi 1.8 Поддерживается Версия 2504 (сборка 18730.20030) Недоступно Версия 16.96 (25041326) Недоступно
PowerPointApi 1.7 Поддерживается Версия 2412 (сборка 18324.20030) Недоступно Версия 16.92 (24120731) Недоступно
PowerPointApi 1.6 Поддерживается Версия 2410 (сборка 18129.20030) Недоступно Версия 16.90 (24101387) Недоступно
PowerPointApi 1.5 Поддерживается Версия 2208 (сборка 15601.20230) Office 2024: версия 2208 (сборка 15601.20230) Версия 16.64 (22080400) Недоступно
PowerPointApi 1.4 Поддерживается Версия 2207 (сборка 15330.20122) Office 2024: версия 2207 (сборка 15330.20122) Версия 16.62 (22061100) Недоступно
PowerPointApi 1.3 Поддерживается Версия 2111 (сборка 14701.20060) Office 2024: версия 2111 (сборка 14701.20060) Версия 16.55 (21111400) Недоступно
PowerPointApi 1.2 Поддерживается Версия 2011 (сборка 13426.20184) Office 2021: версия 2011 (сборка 13426.20184) Версия 16.43 (20110804) Недоступно
PowerPointApi 1.1 Поддерживается Версия 1810 (сборка 11001.20074) Office 2021: версия 1810 (сборка 11001.20074) Версия 16.19 (18110915) Версия 2.17

Номера версий и сборок Office

Дополнительные сведения о номерах версий и сборок Office см. в следующих статьях:

API JavaScript для PowerPoint 1.1

API JavaScript для PowerPoint 1.1 содержит единый API для создания новых презентаций. Сведения об этом API см. в разделе Создание презентации.

API JavaScript 1.2 для PowerPoint

API JavaScript 1.2 для PowerPoint добавляет поддержку вставки слайдов из другой презентации PowerPoint в текущую презентацию, а также поддержку удаления слайдов. Дополнительные сведения об API см. в статье Вставка и удаление слайдов в презентации PowerPoint.

API JavaScript 1.3 для PowerPoint

API JavaScript 1.3 для PowerPoint предоставляет дополнительную поддержку для добавления и удаления слайдов. Он также позволяет надстройкам применять настраиваемые теги метаданных. Дополнительные сведения об API см. статью Добавление и удаление слайдов в PowerPoint и Использование пользовательских тегов для презентаций, слайдов и фигур в PowerPoint.

API JavaScript PowerPoint 1.4

PowerPoint JavaScript API 1.4 добавляет дополнительную поддержку для добавления, перемещения, изменения размеров, форматирования и удаления фигур. Дополнительные сведения об использовании этих API см. в статье Работа с фигурами.

PowerPoint JavaScript API 1.5

PowerPoint JavaScript API 1.5 включает API для получения существующих гиперссылок в презентациях и управления ими. Дополнительные сведения см. в статье Набор требований API JavaScript PowerPoint 1.5.

API JavaScript PowerPoint 1.6

PowerPoint JavaScript API 1.6 включает API для выбора слайдов, текстовых диапазонов и фигур в презентациях. Дополнительные сведения см. в статье Набор требований API JavaScript для PowerPoint 1.6.

PowerPoint JavaScript API 1.7

PowerPoint JavaScript API 1.7 включает API-интерфейсы для управления пользовательскими свойствами и свойствами документов в презентациях. Дополнительные сведения см. в статье Набор требований API JavaScript PowerPoint 1.7.

API JavaScript PowerPoint 1.8

PowerPoint JavaScript API 1.8 включает API для управления привязками, фигурами и таблицами в презентациях. Дополнительные сведения см. в статье Набор требований API JavaScript PowerPoint 1.8.

API JavaScript PowerPoint 1.9

PowerPoint JavaScript API 1.9 включает API для форматирования таблиц в презентациях и управления ими. Дополнительные сведения см. в статье Набор требований API JavaScript для PowerPoint 1.9.

API JavaScript PowerPoint 1.10

PowerPoint JavaScript API 1.10 включает API-интерфейсы для лучшего управления специальными возможностями, фоном слайдов и гиперссылками в презентациях. Дополнительные сведения см. в статье Набор требований API JavaScript для PowerPoint 1.10.

Использование наборов обязательных элементов PowerPoint в среде выполнения и в манифесте

Примечание.

В этом разделе предполагается, что вы знакомы с общими сведениями о наборах обязательных элементов, изложенными в статьях Версии и наборы обязательных элементов Office и Указание приложений и обязательных элементов API Office.

Наборы требований — это именованные группы элементов API. Надстройка Office может выполнить проверку в среде выполнения или использовать указанные в манифесте наборы обязательных элементов, чтобы определить, поддерживает ли приложение Office необходимые надстройке API.

Проверка поддержки наборов обязательных элементов в среде выполнения

В следующем примере кода показано, как определить, поддерживает ли приложение Office, в котором запускается надстройка, указанный набор обязательных элементов API.

if (Office.context.requirements.isSetSupported('PowerPointApi', '1.1')) {
  // Perform actions.
} else {
  // Provide alternate flow/logic.
}

Определение поддержки наборов обязательных элементов в манифесте

С помощью элемента Requirements в манифесте надстройки можно указать минимальные наборы обязательных элементов и/или методы API, необходимые надстройке для активации. Если приложение или платформа Office не поддерживает наборы обязательных элементов или методы API, указанные в элементе манифеста Requirements, надстройка не будет работать в этом приложении или на этой платформе и не будет отображать список надстроек, показанный в разделе Мои надстройки. Если вашей надстройке для полной функциональности необходим определенный набор обязательных элементов, но она может быть полезна пользователям даже на тех платформах, которые не поддерживают этот набор, мы рекомендуем проверить поддержку обязательных элементов в среде выполнения как описано выше, а не прописывать поддержку набора обязательных элементов в манифесте.

В следующем примере кода показан элемент Requirements в манифесте надстройки, где указано, что надстройка должна загружаться во всех клиентских приложениях Office, поддерживающих набор обязательных элементов PowerPointApi версии 1.1 или более поздней.

<Requirements>
   <Sets DefaultMinVersion="1.1">
      <Set Name="PowerPointApi" MinVersion="1.1"/>
   </Sets>
</Requirements>

Наборы обязательных элементов общего API для Office

Большинство функций надстройки PowerPoint определяются набором обязательных элементов общего API. Сведения о наборах обязательных элементов общего API см. в статье Наборы обязательных элементов общего API для Office.

См. также