OverriddenByRibbonApi element (Elemento OverriddenByRibbonApi)

  • Artigo

Especifica se um controlo grupo, botão, controlo menu ou item de menu será ocultado nas combinações de aplicações e plataformas que suportam a API (Office.ribbon.requestCreateControls) que instala separadores contextuais personalizados no friso.

Tipo de suplemento: Painel de tarefas

Válido apenas nestes esquemas VersionOverrides:

  • Painel de tarefas 1.0

Para obter mais informações, veja Substituições de versões no manifesto apenas do suplemento.

Associados a estes conjuntos de requisitos:

  • Friso 1.2 (Necessário para o Excel, PowerPoint e Word.)

Se este elemento for omitido, a predefinição é false. Se for utilizado, tem de ser o primeiro elemento subordinado do respetivo elemento principal.

Observação

Para uma compreensão completa deste elemento, leia Implementar uma experiência de IU alternativa quando os separadores contextuais personalizados não são suportados.

O objetivo deste elemento é criar uma experiência de contingência num suplemento que implementa separadores contextuais personalizados quando o suplemento está em execução numa aplicação ou plataforma que não suporta separadores contextuais personalizados. A estratégia essencial é duplicar alguns ou todos os grupos e controlos do separador contextual personalizado para um separador de núcleo personalizado (ou seja, separador personalizado não contextual ). Em seguida, para garantir que estes grupos e controlos são apresentados quando os separadores contextuais personalizados não são suportados, mas não aparecem quando são suportados separadores contextuais personalizados, adicione <OverriddenByRibbonApi>true</OverriddenByRibbonApi> como o primeiro elemento subordinado dos <elementos de Grupo>, <Controlo> ou Item> de menu<. O efeito deste procedimento é o seguinte:

  • Se o suplemento for executado numa aplicação e plataforma que suportem separadores contextuais personalizados, os grupos e controlos duplicados não serão apresentados no friso. Em vez disso, o separador contextual personalizado será instalado quando o suplemento chamar o requestCreateControls método .
  • Se o suplemento for executado numa aplicação ou plataforma que não suporte separadores contextuais personalizados, os grupos e controlos duplicados serão apresentados no friso.

Exemplos

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

Substituir um controlo

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

Substituir um item de menu

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