JavaScript-API-Anforderungssätze für PowerPoint

  • Artikel

Anforderungssätze sind benannte Gruppen von API-Mitgliedern. Office-Add-Ins verwenden im Manifest angegebene Anforderungssätze oder ermitteln mithilfe einer Laufzeitüberprüfung, ob eine Office-Anwendung APIs unterstützt, die von einem Add-In benötigt werden. Weitere Informationen finden Sie unter Office-Versionen und Anforderungssätze.

In der folgenden Tabelle sind die PowerPoint-Anforderungssätze, die unterstützten Office-Clientanwendungen und ggf. die Mindestbuilds oder -versionen für diese Anwendungen aufgeführt.

Anforderungssatz Office unter Windows
– Microsoft 365-Abonnement
– Unbefristetes Office 2016 und höher im Einzelhandel		 Office unter Windows
(Volumenlizenz unbefristet)		 Office für Mac Office auf dem iPad Office im Web
Preview Verwenden Sie die neueste Office-Version, um Vorschau-APIs auszuprobieren (möglicherweise müssen Sie dem Microsoft 365 Insider-Programm beitreten).
PowerPointApi 1.5 Version 2208 (Build 15601.20230) Nicht verfügbar 16.64.804.0 Nicht verfügbar Unterstützt
PowerPointApi 1.4 Version 2207 (Build 15330.20122) Nicht verfügbar 16.62 Nicht verfügbar Unterstützt
PowerPointApi 1.3 Version 2111 (Build 14701.20060) Nicht verfügbar 16.55 Nicht verfügbar Unterstützt
PowerPointApi 1.2 Version 2011 (Build 13426.20184) Office 2021: Version 2011 (Build 13426.20184) 16.43 Nicht verfügbar Unterstützt
PowerPointApi 1.1 Version 1810 (Build 11001.20074) Office 2021: Version 1810 (Build 11001.20074) 16.19 2.17 Unterstützt

Office-Versionen und Buildnummern

Weitere Informationen zu Office-Versionen und Buildnummern finden Sie unter:

PowerPoint-JavaScript-API 1.1

PowerPoint-JavaScript-API 1.1 enthält eine einzelne API zum Erstellen einer neuen Präsentation. Details zur API finden Sie unter Erstellen von Präsentationen.

PowerPoint-JavaScript-API 1.2

PowerPoint-JavaScript-API 1.2 bietet Unterstützung für das Einfügen von Folien aus einer anderen PowerPoint-Präsentation in die aktuelle Präsentation und für das Löschen von Folien. Details zu den APIs finden Sie unter Einfügen und Löschen von Folien in einer PowerPoint-Präsentation.

PowerPoint JavaScript-API 1.3

PowerPoint JavaScript-API 1.3 bietet zusätzliche Unterstützung für das Hinzufügen und Löschen von Folien. Außerdem können Add-Ins benutzerdefinierte Metadatentags anwenden. Ausführliche Informationen zu den APIs finden Sie unter Hinzufügen und Löschen von Folien in PowerPoint und Verwenden von benutzerdefinierten Tags für Präsentationen, Folien und Formen in PowerPoint.

PowerPoint JavaScript-API 1.4

Die PowerPoint JavaScript-API 1.4 bietet zusätzliche Unterstützung für das Hinzufügen, Verschieben, Dimensionieren, Formatieren und Löschen von Shapes. Weitere Informationen zur Verwendung dieser APIs finden Sie unter Arbeiten mit Shapes.

PowerPoint JavaScript-API 1.5

Die PowerPoint-JavaScript-API 1.5 enthält APIs zum Auswählen von Folien, Textbereichen und Formen in Präsentationen. Weitere Informationen finden Sie unter PowerPoint JavaScript-API-Anforderungssatz 1.5.

Verwenden von PowerPoint-Anforderungsgruppen zur Laufzeit und im Manifest

Hinweis

In diesem Abschnitt wird vorausgesetzt, dass Sie mit der Übersicht der Anforderungsgruppen auf Office-Versionen und Anforderungsgruppen vertraut sind und die Office-Anwendungen und API-Anforderungenangeben.

Anforderungssätze sind benannte Gruppen von API-Mitgliedern. Ein Office-Add-Ins kann eine Laufzeitüberprüfung durchführen oder die in der Manifestdatei angegebenen Anforderungssätze verwenden, um zu bestimmen, ob eine Office-Anwendung die APIs unterstützt, die das Add-In benötigt.

Überprüfen der Unterstützung der Anforderungssätze zur Laufzeit

Im folgenden Codebeispiel wird gezeigt, wie Sie ermitteln, ob die Office-Anwendung, in dem das Add-In ausgeführt wird, den angegebenen API-Anforderungssatz unterstützt.

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

Definieren der Unterstützung der Anforderungssätze in der Manifestdatei

Sie können das Anforderungselement in der Manifestdatei des Add-Ins verwenden, um die Mindesteinstellungen und/oder API-Methoden, die für die Aktivierung Ihrer Add-In erforderlich sind, festzulegen. Wenn die Office-Anwendung oder -Plattform die im Requirements-Element des Manifests angegebenen Anforderungsgruppen oder API-Methoden nicht unterstützt, wird das Add-In nicht in dieser Anwendung oder Plattform ausgeführt, und es wird nicht in der Liste der Add-Ins angezeigt, die in meine Add-Ins angezeigt werden. Wenn das Add-In einen bestimmten Anforderungssatz für die vollständige Funktionalität erfordert, aber auch für Benutzer auf Plattformen, die die Anforderungsgruppe nicht unterstützen, einen Wert bieten kann, empfehlen wir, dass Sie die Anforderungsunterstützung zur Laufzeit überprüfen, wie oben beschrieben, anstatt die Anforderungssatz-Unterstützung im Manifest zu definieren.

Das folgende Codebeispiel zeigt das Requirements-Element in einer Add-In-Manifestdatei, das angibt, dass das Add-In in alle Office-Clientanwendungen geladen werden soll, welche die PowerPointApi-Anforderungssatz-Version 1.1 oder höher unterstützen.

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

Allgemeine Office-API-Anforderungssätze

Die meisten Funktionen von PowerPoint-Add-Ins stammen aus dem allgemeinen API-Satz. Informationen zu allgemeinen API-Anforderungssätzen finden Sie unter Allgemeine Office-API-Anforderungssätze.

Siehe auch