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.

Geben Sie an, wo eine benutzerdefinierte Registerkarte angezeigt werden soll, indem Sie angeben, welche integrierte Office-Registerkarte neben der Registerkarte angezeigt werden soll, und geben Sie an, ob sie sich links oder rechts auf der integrierten Registerkarte befinden soll. Machen Sie diese Spezifikationen, indem Sie entweder ein InsertBefore-Element (links) oder ein InsertAfter-Element (rechts) in das CustomTab-Element des Add-In-Manifests einschließen. (Sie können nicht über beide Elemente verfügen.)

Im folgenden Beispiel ist die benutzerdefinierte Registerkarte so konfiguriert, dass sie direkt nach der Registerkarte Überprüfen angezeigt wird. Beachten Sie, dass der Wert des <InsertAfter-Elements> die ID der integrierten Office-Registerkarte ist.

<ExtensionPoint xsi:type="ContosoRibbonTab">
  <CustomTab id="Contoso.TabCustom2">
    <Group id="Contoso.TabCustom2.group2">
       <!-- additional markup omitted -->
    </Group>
    <Label resid="customTabLabel1" />
    <InsertAfter>TabReview</InsertAfter>
  </CustomTab>
</ExtensionPoint>

Beachten Sie die folgenden Punkte.

  • Die <Elemente InsertBefore> und <InsertAfter> sind optional. Wenn Sie keines der beiden Verwenden, wird Ihre benutzerdefinierte Registerkarte als die ganz rechts stehende Registerkarte im Menüband angezeigt.
  • Die <Elemente InsertBefore> und <InsertAfter> schließen sich gegenseitig aus. Sie können nicht beides verwenden.
  • 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 die <Elemente InsertBefore> und <InsertAfter> als 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 mit <InsertBefore>TabHome</InsertBefore>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, fügen Sie im Abschnitt Anforderungen> des Manifests einen Verweis auf den< Anforderungssatz hinzu. 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.