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

Статья
10/30/2024

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

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

Набор обязательных элементов	Office в Интернете	Office для Windows Подписка на Microsoft 365 розничный бессрочный	Office для Windows корпоративный бессрочный	Office для Mac	Office для iPad
Предварительный просмотр	Используйте последнюю версию Office, чтобы попробовать предварительные версии API (возможно, вам потребуется присоединиться к программе предварительной оценки Microsoft 365).
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

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

API JavaScript для PowerPoint 1.5

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

API JavaScript для PowerPoint 1.6

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

Использование наборов обязательных элементов 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.

Поделиться через