Freigeben über

Positionieren einer benutzerdefinierten Registerkarte im Menüband

Sie können angeben, wo die benutzerdefinierte Registerkarte Ihres Add-Ins im Menüband der Office-Anwendung angezeigt werden soll, indem Sie Markup im Manifest des Add-Ins verwenden.

Hinweis

In diesem Artikel wird davon ausgegangen, dass Sie mit dem Artikel Grundlegende Konzepte für Add-In-Befehle vertraut sind. Bitte überprüfen Sie es, wenn Sie dies in letzter Zeit noch nicht getan haben.

Wichtig

  • Das in diesem Artikel beschriebene Add-In-Feature und Markup ist nur in PowerPoint im Web verfügbar.
  • Das in diesem Artikel beschriebene Markup funktioniert nur auf Plattformen, die den Anforderungssatz AddinCommands 1.3 unterstützen. Siehe Verhalten auf nicht unterstützten Plattformen weiter unten.

Standardmäßig wird am Ende des Menübands eine benutzerdefinierte Registerkarte hinzugefügt. Sie können jedoch angeben, wo eine benutzerdefinierte Registerkarte angezeigt werden soll, indem Sie angeben, welche integrierte Office-Registerkarte neben sie sich befinden soll, und angeben, ob sie sich auf der linken oder rechten Seite der integrierten Registerkarte befinden soll. Öffnen Sie die Registerkarte für den Manifesttyp, den Ihr Add-In für die Details des Manifestmarkups verwendet.

Hinweis

Das einheitliche Manifest für Microsoft 365 kann in Outlook-Produktions-Add-Ins verwendet werden. Es ist nur als Vorschau für Excel-, PowerPoint- und Word-Add-Ins verfügbar.

Um die benutzerdefinierte Registerkarte zu positionieren, fügen Sie eine -Eigenschaft in das "extensions.ribbons.tabs" -Objekt ein"position". Legen Sie die "position.builtInTabId" -Eigenschaft auf die ID der integrierten Registerkarte fest, neben der sich Die benutzerdefinierte Registerkarte befinden soll. (Weitere Informationen finden Sie unter Suchen der IDs von integrierten Office-Menübandregisterkarten.) Legen Sie die "position.align" Eigenschaft entweder "before" auf (links) oder "after" (rechts) fest.

Im folgenden Beispiel ist die benutzerdefinierte Registerkarte so konfiguriert, dass sie direkt nach der Registerkarte Überprüfen angezeigt wird.

"extensions": [
    ...
    {
        ...
        "ribbons": [
            ...
            {
                ...
                "tabs": [
                    {
                        "id": "MyTab",
                        ...
                        "position": {
                            "builtInTabId": "TabReview",
                            "align": "after"
                        }
                    }
                ]
            }
        ]
    }
]

Auswirkungen von Benutzeraktionen auf die Positionierung benutzerdefinierter Registerkarten

  • Wenn der Benutzer mehrere Add-Ins installiert, deren benutzerdefinierte Registerkarte für denselben Ort konfiguriert ist, z. B. nach der Registerkarte Überprüfen , befindet sich die Registerkarte für das zuletzt installierte Add-In an dieser Stelle. Die Registerkarten der zuvor installierten Add-Ins werden an einem Ort verschoben. Beispielsweise installiert der Benutzer die Add-Ins A, B und C in dieser Reihenfolge, und alle sind so konfiguriert, dass sie nach der Registerkarte Überprüfen eine Registerkarte einfügen. Dann werden die Registerkarten in der folgenden Reihenfolge angezeigt: Überprüfen, AddinCTab, AddinBTab, AddinATab.
  • Benutzer können das Menüband in der Office-Anwendung anpassen. Beispielsweise kann ein Benutzer die Registerkarte Ihres Add-Ins verschieben oder ausblenden. Sie können dies nicht verhindern oder erkennen, dass dies geschehen ist.
  • Wenn ein Benutzer eine der integrierten Registerkarten verschiebt, interpretiert Office das Positionierungsmarkup im Manifest in Bezug auf die Standardposition der integrierten Registerkarte. Wenn der Benutzer z. B. die Registerkarte Überprüfen an das rechte Ende des Menübands verschiebt, interpretiert Office das Markup im vorherigen Beispiel als "platzieren Sie die benutzerdefinierte Registerkarte direkt rechts neben der Standardmäßigen Registerkarte Überprüfen".

Angeben, welche Registerkarte den Fokus hat, wenn das Dokument geöffnet wird

Office setzt immer den Standardfokus auf die Registerkarte, die sich direkt rechts neben der Registerkarte Datei befindet. Standardmäßig ist dies die Registerkarte Start . Wenn Sie ihre benutzerdefinierte Registerkarte so konfigurieren, dass sie vor der Registerkarte Start liegt, hat die benutzerdefinierte Registerkarte den Fokus, wenn das Dokument geöffnet wird.

Wichtig

Wenn Sie Ihrem Add-In übermäßige Bedeutung geben, könnte dies Benutzer und Administratoren stören und verärgern. Positionieren Sie eine benutzerdefinierte Registerkarte nicht vor der Registerkarte Start , es sei denn, Ihr Add-In ist die primäre Art und Weise, wie Benutzer mit dem Dokument interagieren.

Verhalten auf nicht unterstützten Plattformen

Wenn Ihr Add-In auf einer Plattform installiert ist, die den Anforderungssatz AddinCommands 1.3 nicht unterstützt, wird das in diesem Artikel beschriebene Markup ignoriert, und Ihre benutzerdefinierte Registerkarte wird als die äußerste rechte Registerkarte im Menüband angezeigt. Um zu verhindern, dass Ihr Add-In auf Plattformen installiert wird, die das Markup nicht unterstützen, müssen Sie AddinCommands 1.3 im Manifest als Installationsanforderung angeben. Anweisungen finden Sie unter Angeben, welche Office-Versionen und Plattformen Ihr Add-In hosten können. Alternativ können Sie Ihr Add-In so entwerfen, dass es eine alternative Oberfläche hat, wenn AddinCommands 1.3 nicht unterstützt wird, wie unter Entwerfen für alternative Umgebungen beschrieben. Wenn Ihr Add-In z. B. Anweisungen enthält, die davon ausgehen, dass sich die benutzerdefinierte Registerkarte an der gewünschten Stelle befindet, können Sie eine alternative Version verwenden, die davon ausgeht, dass sich die Registerkarte am weitesten rechts befindet.

  • Last updated on