Elemento OverriddenByRibbonApi

Especifica si un control Group, Button, Menu o menu se ocultará en las combinaciones de aplicaciones y plataformas que admiten la API (Office.ribbon.requestCreateControls) que instala pestañas contextuales personalizadas en la cinta de opciones.

Tipo de complemento: Panel de tareas

Solo es válido en estos esquemas VersionOverrides:

• Panel de tareas 1.0

Para obtener más información, vea Invalidaciones de versión en el manifiesto.

Asociado a estos conjuntos de requisitos:

• Cinta 1.2 (requerida para Excel, PowerPoint y Word).

Si se omite este elemento, el valor predeterminado es false. Si se usa, debe ser el primer elemento secundario de su elemento primario.

Nota:

Para obtener una comprensión completa de este elemento, lea Implementar una experiencia de interfaz de usuario alternativa cuando no se admiten pestañas contextuales personalizadas.

El propósito de este elemento es crear una experiencia de reserva en un complemento que implementa pestañas contextuales personalizadas cuando el complemento se ejecuta en una aplicación o plataforma que no admite pestañas contextuales personalizadas. La estrategia esencial es duplicar algunos o todos los grupos y controles de la pestaña contextual personalizada en una pestaña principal personalizada (es decir, una pestaña personalizada nocontextual ). A continuación, para asegurarse de que estos grupos y controles aparecen cuando no se admiten pestañas contextuales personalizadas, pero no aparecen cuando se admiten pestañas contextuales personalizadas, agregue <OverriddenByRibbonApi>true</OverriddenByRibbonApi> como el primer elemento secundario de los <elementos Group>, <Control> o Item> del menú<. El efecto de hacerlo es el siguiente:

• Si el complemento se ejecuta en una aplicación y plataforma que admiten pestañas contextuales personalizadas, los grupos y controles duplicados no aparecerán en la cinta de opciones. En su lugar, la pestaña contextual personalizada se instalará cuando el complemento llame al requestCreateControls método .
• Si el complemento se ejecuta en una aplicación o plataforma que no admite pestañas contextuales personalizadas, los grupos y controles duplicados aparecerán en la cinta de opciones.

Ejemplos

Invalidación de un grupo

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

Invalidación de un control

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

Reemplazar un elemento de menú

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