Freigeben über


OverriddenByRibbonApi-Element

Gibt an, ob ein Gruppen-, Schaltflächen-, Menü-Steuerelement oder Menüelement in Anwendungs- und Plattformkombinationen ausgeblendet wird, die die API (Office.ribbon.requestCreateControls) unterstützen, die benutzerdefinierte kontextbezogene Registerkarten im Menüband installiert.

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:

Wenn dieses Element nicht angegeben wird, ist falseder Standardwert . Wenn es verwendet wird, muss es das erste untergeordnete Element des übergeordneten Elements sein.

Der Zweck dieses Elements besteht darin, eine Fallbackumgebung in einem Add-In zu erstellen, das benutzerdefinierte kontextbezogene Registerkarten implementiert, wenn das Add-In auf einer Anwendung oder Plattform ausgeführt wird, die keine benutzerdefinierten kontextbezogenen Registerkarten unterstützt. Die wesentliche Strategie besteht darin, dass Sie einige oder alle Gruppen und Steuerelemente von Ihrer benutzerdefinierten Kontextregisterkarte auf einer benutzerdefinierten Kernregisterkarte duplizieren (d. a. nicht kontextbezogene benutzerdefinierte Registerkarte). Um dann sicherzustellen, dass diese Gruppen und Steuerelemente angezeigt werden, wenn benutzerdefinierte kontextbezogene Registerkarten nicht unterstützt werden, aber nicht angezeigt werden, wenn benutzerdefinierte kontextbezogene Registerkarten unterstützt werden , fügen <OverriddenByRibbonApi>true</OverriddenByRibbonApi> Sie als erstes untergeordnetes Element der <Elemente Group>, <Control> oder menu <Item> hinzu. Dies hat folgende Auswirkungen:

  • Wenn das Add-In auf einer Anwendung und Plattform ausgeführt wird, die benutzerdefinierte kontextbezogene Registerkarten unterstützen, werden die duplizierten Gruppen und Steuerelemente nicht im Menüband angezeigt. Stattdessen wird die benutzerdefinierte Kontextregisterkarte installiert, wenn das Add-In die requestCreateControls -Methode aufruft.
  • Wenn das Add-In auf einer Anwendung oder Plattform ausgeführt wird, die keine benutzerdefinierten kontextbezogenen Registerkarten unterstützt, werden die duplizierten Gruppen und Steuerelemente im Menüband angezeigt.

Beispiele

Überschreiben einer Gruppe

<ExtensionPoint xsi:type="PrimaryCommandSurface">
  <CustomTab id="Contoso.TabCustom">
    <Group id="Contoso.CustomTab.group1">
      <OverriddenByRibbonApi>true</OverriddenByRibbonApi>
      <Control  xsi:type="Button" id="Contoso.MyButton1">
        <!-- Child elements omitted. -->
      </Control>
    </Group>
    <Label resid="customTabLabel"/>
  </CustomTab>
</ExtensionPoint>

Überschreiben eines Steuerelements

<ExtensionPoint xsi:type="PrimaryCommandSurface">
  <CustomTab id="Contoso.TabCustom">
    <Group id="Contoso.CustomTab.group2">
      <Control  xsi:type="Button" id="Contoso.MyButton2">
        <OverriddenByRibbonApi>true</OverriddenByRibbonApi>
        <!-- Other child elements omitted. -->
      </Control>
    </Group>
    <Label resid="customTabLabel"/>
  </CustomTab>
</ExtensionPoint>

Überschreiben eines Menüelements

<ExtensionPoint xsi:type="PrimaryCommandSurface">
  <CustomTab id="Contoso.TabCustom">
    <Group id="Contoso.CustomTab.group3">
      <Control  xsi:type="Menu" id="Contoso.MyMenu">
        <!-- Other child elements omitted. -->
        <Items>
          <Item id="showGallery">
            <OverriddenByRibbonApi>true</OverriddenByRibbonApi>
            <!-- Other child elements omitted. -->
          </Item>
        </Items>
      </Control>
    </Group>
    <Label resid="customTabLabel"/>
  </CustomTab>
</ExtensionPoint>