Integrieren integrierter Office-Schaltflächen in benutzerdefinierte Steuerelementgruppen und Registerkarten

Sie können integrierte Office-Schaltflächen in Ihre benutzerdefinierten Steuerelementgruppen im Office-Menüband einfügen, indem Sie Markup im Manifest des Add-Ins verwenden. (Sie können Ihre benutzerdefinierten Add-In-Befehle nicht in eine integrierte Office-Gruppe einfügen.) Sie können auch ganze integrierte Office-Steuerelementgruppen in Ihre benutzerdefinierten Menübandregister einfügen.

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, unter Windows und unter Mac verfügbar.
• Das in diesem Artikel beschriebene Markup funktioniert nur auf Plattformen, die den Anforderungssatz AddinCommands 1.3 unterstützen. Weitere Informationen finden Sie im späteren Abschnitt Verhalten auf nicht unterstützten Plattformen.

Einfügen einer integrierten Steuerelementgruppe in eine benutzerdefinierte Registerkarte

Um eine integrierte Office-Steuerelementgruppe in eine Registerkarte einzufügen, fügen Sie ein OfficeGroup-Element als untergeordnetes Element im übergeordneten< CustomTab-Element> hinzu. Das id -Attribut des <OfficeGroup-Elements> wird auf die ID der integrierten Gruppe festgelegt. Weitere Informationen finden Sie unter Suchen der IDs von Steuerelementen und Steuerelementgruppen.

Im folgenden Markupbeispiel wird die Office Absatz-Steuerelementgruppe einer benutzerdefinierten Registerkarte hinzugefügt und direkt nach einer benutzerdefinierten Gruppe angezeigt.

<ExtensionPoint xsi:type="ContosoRibbonTab">
  <CustomTab id="Contoso.TabCustom1">
    <Group id="Contoso.myCustomTab.group1">
       <!-- additional markup omitted -->
    </Group>
    <OfficeGroup id="Paragraph" />
    <Label resid="customTabLabel1" />
  </CustomTab>
</ExtensionPoint>

Einfügen eines integrierten Steuerelements in eine benutzerdefinierte Gruppe

Um ein integriertes Office-Steuerelement in eine benutzerdefinierte Gruppe einzufügen, fügen Sie ein OfficeControl-Element als untergeordnetes Element im übergeordneten <Group-Element> hinzu. Das id Attribut des <OfficeControl-Elements> wird auf die ID des integrierten Steuerelements festgelegt. Weitere Informationen finden Sie unter Suchen der IDs von Steuerelementen und Steuerelementgruppen.

Das folgende Markupbeispiel fügt das Office Superscript-Steuerelement einer benutzerdefinierten Gruppe hinzu und positioniert es so, dass es direkt nach einer benutzerdefinierten Schaltfläche angezeigt wird.

<ExtensionPoint xsi:type="ContosoRibbonTab">
  <CustomTab id="Contoso.TabCustom2">
    <Group id="Contoso.TabCustom2.group1">
        <Label resid="residCustomTabGroupLabel"/>
        <Icon>
            <bt:Image size="16" resid="blue-icon-16" />
            <bt:Image size="32" resid="blue-icon-32" />
            <bt:Image size="80" resid="blue-icon-80" />
        </Icon>
        <Control xsi:type="Button" id="Contoso.Button1">
            <!-- Information on the control omitted. -->
        </Control>
        <OfficeControl id="Superscript" />
        <!-- Other controls, as needed. -->
    </Group>
    <Label resid="customTabLabel1" />
  </CustomTab>
</ExtensionPoint>

Hinweis

Benutzer können das Menüband in der Office-Anwendung anpassen. Alle Benutzeranpassungen überschreiben Ihre Manifesteinstellungen. Beispielsweise kann ein Benutzer eine Schaltfläche aus einer beliebigen Gruppe und eine beliebige Gruppe von einer Registerkarte entfernen.

Suchen der IDs von Steuerelementen und Steuerelementgruppen

Die IDs für unterstützte Steuerelemente und Steuerelementgruppen befinden sich in Dateien in den Office-Steuerelement-IDs des Repositorys. Befolgen Sie die Anweisungen in der Infodatei dieses Repositorys.

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 die integrierten Office-Steuerelemente/-Gruppen werden nicht in Ihren benutzerdefinierten Gruppen/Registerkarten 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 Benutzeroberfläche aufweist, wenn AddinCommands 1.3 nicht unterstützt wird, wie unter Entwerfen für alternative Umgebungen beschrieben. Wenn Ihr Add-In beispielsweise Anweisungen enthält, die davon ausgehen, dass sich die integrierten Schaltflächen in Ihren benutzerdefinierten Gruppen befinden, können Sie eine Version entwerfen, die davon ausgeht, dass sich die integrierten Schaltflächen nur an ihren üblichen Orten befinden.