Group-Element

  • Artikel

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

Diesen Anforderungssätzen zugeordnet:

Attribute

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

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

Element Erforderlich Beschreibung
Label Ja Die Bezeichnung für eine Gruppe.
Icon Ja Das Bild für eine Gruppe. Wird in Outlook-Add-Ins nicht unterstützt.
Control Nein Stellt ein Control-Objekt dar. Kann 0 (null) oder mehr sein.
OfficeControl Nein Stellt eines der integrierten Office-Steuerelemente dar. Kann 0 (null) oder mehr sein. Wird nur in PowerPoint-Add-Ins unterstützt.
OverriddenByRibbonApi Nein Gibt an, ob die Gruppe in Anwendungs- und Plattformkombinationen angezeigt werden soll, die benutzerdefinierte kontextbezogene Registerkarten unterstützen. Wird in Outlook-Add-Ins nicht unterstützt.

Beschriftung

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.

Symbol

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

Hinweis

Dieses untergeordnete Element wird in Outlook-Add-Ins nicht unterstützt.

Kontrolle

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

Diesen Anforderungssätzen zugeordnet:

Hinweis

Dieses untergeordnete Element wird nur in PowerPoint-Add-Ins unterstützt.

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

Hinweis

Dieses untergeordnete Element wird in Outlook-Add-Ins nicht unterstützt.

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