CustomTab-Element

  • Artikel

Definiert eine benutzerdefinierte Registerkarte für das Office-Menüband. Fügen Sie Menübandsteuerelemente und -gruppen für das Add-In entweder einer der vordefinierten Office-Registerkarten oder 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 über benutzerdefinierte oder integrierte Gruppen verfügen. Add-Ins sind auf eine benutzerdefinierte Registerkarte begrenzt.

Wichtig

In Outlook für Mac ist das <CustomTab-Element> nicht verfügbar, aber Sie können stattdessen benutzerdefinierte Gruppen von Steuerelementen auf einem der integrierten OfficeTabsplatzieren. Sie können integrierte Gruppen nicht auf integrierten Registerkarten in Outlook auf jeder Plattform platzieren.

Add-In-Typ: Aufgabenbereich, E-Mail

Nur in den folgenden VersionOverrides-Schemas gültig:

  • Aufgabenbereich 1.0
  • Mail 1.0
  • Mail 1.1

Weitere Informationen finden Sie unter Versionsüberschreibungen im Manifest.

Hinweis

Einige untergeordnete Elemente sind in den Mail-Schemas ungültig. Weitere Informationen finden Sie unter Untergeordnete 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: In Outlook nicht verfügbar.
Label Ja The label for the CustomTab.
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 <Group> und <OfficeGroup> im Manifest sollte die Reihenfolge sein, in der sie auf der benutzerdefinierten Registerkarte 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 <Group> und <OfficeGroup> im Manifest sollte die Reihenfolge sein, in der sie auf der benutzerdefinierten Registerkarte 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 jedoch für Produktions-Add-Ins in PowerPoint im Web verfügbar.

Add-In-Typ: Aufgabenbereich

Nur in den folgenden VersionOverrides-Schemas gültig:

  • Aufgabenbereich 1.0

Weitere Informationen finden Sie unter Versionsüberschreibungen im Manifest.

Diesen Anforderungssätzen zugeordnet:

Label (Tab)

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

Add-In-Typ: Aufgabenbereich, E-Mail

Nur in den folgenden VersionOverrides-Schemas gültig:

  • Aufgabenbereich 1.0
  • Mail 1.0
  • Mail 1.1

Weitere Informationen finden Sie unter Versionsüberschreibungen im 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 TabHome . B. oder TabReview. Eine Liste der integrierten Registerkarten finden Sie unter OfficeTab. Falls vorhanden, muss sich hinter dem <Label-Element> befinden. Sie können nicht sowohl InsertAfter> als auch<InsertBefore> verwenden.<

Wichtig

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

Add-In-Typ: Aufgabenbereich

Nur in den folgenden VersionOverrides-Schemas gültig:

  • Aufgabenbereich 1.0

Weitere Informationen finden Sie unter Versionsüberschreibungen im 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 TabHome . B. oder TabReview. Der Wert des -Elements ist die ID der integrierten Registerkarte, z TabHome . B. oder TabReview. Eine Liste der integrierten Registerkarten finden Sie unter OfficeTab. Falls vorhanden, muss sich hinter dem <Label-Element> befinden. Sie können nicht sowohl InsertAfter> als auch<InsertBefore> verwenden.<

Wichtig

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

Add-In-Typ: Aufgabenbereich

Nur in den folgenden VersionOverrides-Schemas gültig:

  • Aufgabenbereich 1.0

Weitere Informationen finden Sie unter Versionsüberschreibungen im Manifest.

Diesen Anforderungssätzen zugeordnet:

Beispiele

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.TabCustom">
    <Group id="Contoso.TabCustom1.group1">
       <!-- additional markup omitted -->
    </Group>
    <OfficeGroup id="Paragraph" />
    <Label resid="customTabLabel1" />
  </CustomTab>
</ExtensionPoint>

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.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>