Menüband-API-Anforderungssätze

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.

Der Menüband-API-Satz unterstützt die programmgesteuerte Steuerung, wann benutzerdefinierte Add-In-Befehle (d. h. benutzerdefinierte Menübandschaltflächen und Menüelemente) aktiviert und deaktiviert sind und wann kontextbezogene Registerkarten im Menüband angezeigt werden.

Office-Add-Ins sind auf mehreren Versionen von Office lauffähig. In der folgenden Tabelle sind die Menüband-API-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)
Office unter Windows
(unbefristetes Office 2016 oder höher im Einzelhandel)
Office unter Windows
(Volumenlizenz unbefristet)
Office für Mac Office auf dem iPad Office im Web Office Online Server
RibbonApi 1.2 Version 2102 (Build 13801.20294) Version 2102 (Build 13801.20294) Office 2021: Version 2108 (Build 14326.20454) 16.53.806.0 Nicht unterstützt Unterstützt Nicht unterstützt
RibbonApi 1.1 Weitere Informationen finden Sie unter Support.
section
Version 2006 (Build 13001.20266) Office 2021: Version 2108 (Build 14326.20454) 16.38 Nicht unterstützt Unterstützt Nicht unterstützt

Wichtig

  • Die RibbonApi-Anforderungssätze werden nur für Aufgabenbereich-Add-Ins unterstützt.
  • Die RibbonApi-Anforderungssätze werden nur für Produktions-Add-Ins in Excel unterstützt.
  • RibbonApi 1.1 (nicht 1.2) ist als Vorschauversion in PowerPoint und Word verfügbar, jedoch nur in Office unter Windows (Microsoft 365-Abonnement) und Office für Mac. Es steht auch als Vorschauversion in PowerPoint im Web zur Verfügung. Informationen zum Zugreifen auf Office.js Vorschau-APIs finden Sie unter Zugreifen auf die Office JavaScript-API-Bibliothek.

Unterstützung für Version 1.1 in Office unter Windows (Microsoft 365-Abonnement)

Die Version 1.1 des RibbonApi-Anforderungssatzes wird im Consumerkanal von Version 2006 (Build 13001.20498) unterstützt. Dieser Anforderungssatz wird auch in den Builds Semi-Annual Channel und Monthly Enterprise Channel unterstützt, die seit dem 14. Juli 2020 verfügbar sind. Die mindestens unterstützten Builds für jeden Kanal sind wie folgt:

Kanal Mindestversion Mindestbuild
Aktueller Kanal 2006 13001.20266
Monatlicher Enterprise-Kanal 2005 12827.20538
Monatlicher Enterprise-Kanal 2004 12730.20602
Halbjährlicher Enterprise-Kanal 2002 12527.20880

Weitere Informationen

Weitere Informationen über Versionen, Buildnummern und Office Online Server finden Sie unter:

Allgemeine Office-API-Anforderungssätze

Informationen zu allgemeinen API-Anforderungssätzen finden Sie unter Allgemeine Office-API-Anforderungssätze.

Menüband-API 1.1

Die Menüband-API 1.1 ist die erste Version der API. Ausführliche Informationen zur API finden Sie im Office.ribbon-Referenzthema .

Dieser Anforderungssatz umfasst Unterstützung für das Aktivieren und Deaktivieren von Add-In-Befehlen. Weitere Informationen finden Sie unter Aktivieren und Deaktivieren von Add-In-Befehlen.

Menüband-API 1.2

Die Menüband-API 1.2 fügt Unterstützung für kontextbezogene Registerkarten hinzu. Weitere Informationen finden Sie unter Erstellen von benutzerdefinierten kontextbezogenen Registerkarten in Office-Add-Ins.

Hinweis

Der RibbonApi 1.2-Anforderungssatz wird im Manifest noch nicht unterstützt, sodass Sie ihn nicht im Abschnitt Anforderungen> des Manifests< angeben sollten.

Siehe auch