CustomTab-Element

Definiert eine benutzerdefinierte Registerkarte für das Office-Menüband. Fügen Sie Menübandsteuerelemente und Gruppen für das Add-In entweder zu einer der integrierten Office-Registerkarten oder zu Ihrer eigenen benutzerdefinierten Registerkarte hinzu. Verwenden Sie das <CustomTab-Element> , um dem Menüband eine benutzerdefinierte Registerkarte hinzuzufügen. Auf benutzerdefinierten Registerkarten kann das Add-In benutzerdefinierte oder integrierte Gruppen haben. Add-Ins sind auf eine benutzerdefinierte Registerkarte begrenzt.

Wichtig

In Outlook im Web, auf dem Mac und im neuen Outlook unter Windows ist das <CustomTab-Element> nicht verfügbar, aber Sie können stattdessen benutzerdefinierte Gruppen von Steuerelementen auf einem der integrierten OfficeTabsplatzieren. IntegrierteGruppen können in Outlook auf keiner Plattform auf integrierten Registerkarten platziert werden.

Add-In-Typ: Aufgabenbereich, Mail

Nur in diesen VersionOverrides-Schemas gültig:

  • Aufgabenbereich 1.0
  • Mail 1.0
  • Mail 1.1

Weitere Informationen finden Sie unter Versionsüberschreibungen im Nur-Add-In-Manifest.

Hinweis

Einige untergeordnete Elemente sind in den Mail-Schemas nicht gültig. Siehe Child-Elemente.

Diesen Anforderungssätzen zugeordnet:

Attribute

Attribut Erforderlich Beschreibung
id Ja Eine eindeutige ID für die benutzerdefinierte Registerkarte.

id-Attribut

Erforderlich. Eindeutiger Bezeichner für die benutzerdefinierte Registerkarte. Es handelt sich um eine Zeichenfolge mit maximal 125 Zeichen. Dies muss innerhalb des Manifests eindeutig sein.

Untergeordnete Elemente

Element Erforderlich Beschreibung
Group Nein Definiert eine Gruppe von Befehlen.
OfficeGroup Nein Stellt eine integrierte Office-Steuerelementgruppe dar. Wichtig: Nicht verfügbar in Outlook.
Label Ja Die Bezeichnung für die Registerkarte "Benutzerdefiniert".
InsertAfter Nein Gibt an, dass sich die benutzerdefinierte Registerkarte unmittelbar nach einer angegebenen integrierten Office-Registerkarte befinden soll. Wichtig: Nur in PowerPoint verfügbar.
InsertBefore Nein Gibt an, dass sich die benutzerdefinierte Registerkarte unmittelbar vor einer angegebenen integrierten Office-Registerkarte befinden soll. Wichtig: Nur in PowerPoint verfügbar.

Gruppe

Optional, aber wenn nicht vorhanden, muss mindestens ein <OfficeGroup-Element> vorhanden sein. Siehe Group-Element. Die Reihenfolge von <Gruppe> und <OfficeGroup> im Manifest sollte der Reihenfolge entsprechen, in der sie auf der Registerkarte Benutzerdefiniert angezeigt werden sollen. Sie können gemischt werden, wenn mehrere Elemente vorhanden sind, aber alle müssen sich über dem <Label-Element> befinden.

OfficeGroup

Optional, aber wenn nicht vorhanden, muss mindestens ein <Group-Element> vorhanden sein. Stellt eine integrierte Office-Steuerelementgruppe dar. Das id-Attribut gibt die ID der integrierten Office-Gruppe an. Informationen zum Ermitteln der ID einer integrierten Gruppe finden Sie unter Suchen der IDs von Steuerelementen und Steuerelementgruppen. Die Reihenfolge von <Gruppe> und <OfficeGroup> im Manifest sollte der Reihenfolge entsprechen, in der sie auf der Registerkarte Benutzerdefiniert angezeigt werden sollen. Sie können gemischt werden, wenn mehrere Elemente vorhanden sind, aber alle müssen sich über dem <Label-Element> befinden.

Wichtig

Das <OfficeGroup-Element> ist in Outlook nicht verfügbar. In PowerPoint befindet es sich in der Vorschau für Mac und Windows; ist aber für Produktions-Add-Ins in PowerPoint im Web verfügbar.

Add-In-Typ: Aufgabenbereich

Nur in diesen VersionOverrides-Schemas gültig:

  • Aufgabenbereich 1.0

Weitere Informationen finden Sie unter Versionsüberschreibungen im Nur-Add-In-Manifest.

Diesen Anforderungssätzen zugeordnet:

Label (Tab)

Erforderlich. Die Bezeichnung der benutzerdefinierten Registerkarte. Das resid-Attribut darf nicht länger als 32 Zeichen sein und muss auf den Wert des id-Attributs eines <String-Elements im ShortStrings-Element>>des Resources-Elements festgelegt< werden.

Add-In-Typ: Aufgabenbereich, Mail

Nur in diesen VersionOverrides-Schemas gültig:

  • Aufgabenbereich 1.0
  • Mail 1.0
  • Mail 1.1

Weitere Informationen finden Sie unter Versionsüberschreibungen im Nur-Add-In-Manifest.

Diesen Anforderungssätzen zugeordnet:

InsertAfter

Optional. Gibt an, dass sich die benutzerdefinierte Registerkarte unmittelbar nach einer angegebenen integrierten Office-Registerkarte befinden soll. Der Wert des Elements ist die ID der integrierten Registerkarte, z. B TabHome . oder TabReview. Eine Liste der integrierten Registerkarten finden Sie unter OfficeTab. Wenn vorhanden, muss nach dem <Label-Element> stehen. Sie können nicht sowohl "InsertAfter>" als auch< "InsertBefore>" haben.<

Wichtig

Das <InsertAfter-Element> ist nur in PowerPoint verfügbar.

Add-In-Typ: Aufgabenbereich

Nur in diesen VersionOverrides-Schemas gültig:

  • Aufgabenbereich 1.0

Weitere Informationen finden Sie unter Versionsüberschreibungen im Nur-Add-In-Manifest.

Diesen Anforderungssätzen zugeordnet:

InsertBefore

Optional. Gibt an, dass sich die benutzerdefinierte Registerkarte unmittelbar vor einer angegebenen integrierten Office-Registerkarte befinden soll. Der Wert des Elements ist die ID der integrierten Registerkarte, z. B TabHome . oder TabReview. Der Wert des Elements ist die ID der integrierten Registerkarte, z. B TabHome . oder TabReview. Eine Liste der integrierten Registerkarten finden Sie unter OfficeTab. Wenn vorhanden, muss nach dem <Label-Element> stehen. Sie können nicht sowohl "InsertAfter>" als auch< "InsertBefore>" haben.<

Wichtig

Das <InsertBefore-Element> ist nur in PowerPoint verfügbar.

Add-In-Typ: Aufgabenbereich

Nur in diesen VersionOverrides-Schemas gültig:

  • Aufgabenbereich 1.0

Weitere Informationen finden Sie unter Versionsüberschreibungen im Nur-Add-In-Manifest.

Diesen Anforderungssätzen zugeordnet:

Beispiele

Im folgenden Markupbeispiel wird die Gruppe "Office-Absatzsteuerelement" einer benutzerdefinierten Registerkarte hinzugefügt und so positioniert, dass sie direkt hinter einer benutzerdefinierten Gruppe angezeigt wird.

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

Im folgenden Markupbeispiel wird das Office Superscript-Steuerelement einer benutzerdefinierten Gruppe hinzugefügt und so positioniert, dass es direkt hinter einer benutzerdefinierten Schaltfläche angezeigt wird.

<ExtensionPoint xsi:type="PrimaryCommandSurface">
  <CustomTab id="Contoso.TabCustom">
    <Group id="Contoso.TabCustom2.group2">
        <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.Button2">
            <!-- Information on the control omitted. -->
        </Control>
        <OfficeControl id="Superscript" />
        <!-- Other controls, as needed. -->
    </Group>
    <Label resid="customTabLabel1" />
  </CustomTab>
</ExtensionPoint>