Group-Element

Definiert eine Gruppe von Ui-Steuerelementen auf einer Registerkarte. Auf benutzerdefinierten Registerkarten kann das Add-In mehrere Gruppen erstellen. Add-Ins sind auf eine benutzerdefinierte Registerkarte begrenzt.

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:

• AddinCommands 1.1

Attribute

id-Attribut

Erforderlich. Eindeutiger Bezeichner für die Gruppe. Es ist eine Zeichenfolge mit maximal 125 Zeichen. Dies muss für alle Group-Elemente im Manifest eindeutig sein.

Untergeordnete Elemente

Label

Erforderlich. Die Beschriftung der Gruppe. 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.

Tooltip

Add-In-Typ: Mail

Nur in den folgenden VersionOverrides-Schemas gültig:

• Mail 1.1

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

Diesen Anforderungssätzen zugeordnet:

• AddinCommands 1.1

Optional. Die QuickInfo für die Gruppe. Das resid-Attribut darf nicht mehr als 32 Zeichen lang sein und muss auf den Wert des id-Attributs eines <String-Elements> festgelegt werden. Das <String-Element> ist ein untergeordnetes Element des <LongStrings-Elements> , das ein untergeordnetes Element des Resources-Elements ist.

Symbol

Erforderlich. Wenn eine Registerkarte viele Gruppen enthält und die Größe des Programmfensters geändert wird, kann stattdessen das angegebene Bild angezeigt werden.

Control

Optional, aber wenn nicht vorhanden, muss mindestens ein <OfficeControl> vorhanden sein. Ausführliche Informationen zu den unterstützten Steuerelementtypen finden Sie im Control-Element . Die Reihenfolge von <Control> und <OfficeControl> im Manifest ist austauschbar, und sie können gemischt werden, wenn mehrere Elemente vorhanden sind, aber alle müssen sich unterhalb des <Icon-Elements> befinden.

<Group id="Contoso.CustomTab1.group1">
    <Label resid="CustomTabGroupLabel"/>
    <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 -->
    </Control>
    <!-- other controls, as needed -->
</Group>

OfficeControl

Optional, aber wenn nicht vorhanden, muss mindestens ein <Steuerelement vorhanden> sein. Schließen Sie mindestens ein integriertes Office-Steuerelement in die Gruppe mit <OfficeControl-Elementen> ein. Das id -Attribut gibt die ID des integrierten Office-Steuerelements an. Informationen zum Ermitteln der ID eines Steuerelements finden Sie unter Suchen der IDs von Steuerelementen und Steuerelementgruppen. Die Reihenfolge von <Control> und <OfficeControl> im Manifest ist austauschbar, und sie können gemischt werden, wenn mehrere Elemente vorhanden sind, aber alle müssen sich unterhalb des <Icon-Elements> befinden.

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:

• AddinCommands 1.3

<Group id="Contoso.CustomTab2.group2">
    <Label resid="CustomTabGroupLabel"/>
    <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 -->
    </Control>
    <OfficeControl id="Superscript" />
    <!-- other controls, as needed -->
</Group>

OverriddenByRibbonApi

Optional (boolescher Wert). Gibt an, ob die <Gruppe> in Anwendungs- und Plattformkombinationen ausgeblendet wird, die eine API unterstützen, die zur Laufzeit eine benutzerdefinierte Kontextregisterkarte auf dem Menüband installiert. Der Standardwert ist false, falls nicht vorhanden, . Bei Verwendung <muss OverriddenByRibbonApi> das erste untergeordnete Element von <Group> sein. Weitere Informationen finden Sie unter OverriddenByRibbonApi.

<ExtensionPoint xsi:type="PrimaryCommandSurface">
  <CustomTab id="Contoso.CustomTab">
    <Group id="Contoso.CustomTab.group1">
      <OverriddenByRibbonApi>true</OverriddenByRibbonApi>
      <!-- other child elements of the group -->
    </Group>
    <Label resid="customTabLabel"/>
  </CustomTab>
</ExtensionPoint>