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 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 auf integrierten Registerkarten in Outlook auf keiner 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 reinen Add-In-Manifest.
Hinweis
Einige untergeordnete Elemente sind in den Mail-Schemas ungültig. Weitere Informationen finden Sie unter Untergeordnete Elemente.
Diesen Anforderungssätzen zugeordnet:
- AddinCommands 1.1
- AddinCommands 1.3. Erforderlich für einige untergeordnete Elemente. Weitere Informationen finden Sie unter Untergeordnete Elemente.
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 reinen Add-In-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 reinen 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 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 reinen 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 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 reinen Add-In-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>
Office Add-ins