Integrar botões incorporados do Office em separadores e grupos de controlo personalizados

Pode inserir botões incorporados do Office nos seus grupos de controlo personalizados no friso do Office através da marcação no manifesto do suplemento. (Não pode inserir os seus comandos de suplemento personalizados num grupo incorporado do Office.) Também pode inserir grupos de controlo do Office incorporados inteiros nos seus separadores personalizados do friso.

Observação

Este artigo pressupõe que está familiarizado com o artigo Conceitos básicos para comandos de suplementos. Reveja-o se ainda não o fez recentemente.

Importante

A funcionalidade de suplemento descrita neste artigo só está disponível no PowerPoint na Web, no Windows e no Mac.

Inserir um grupo de controlo incorporado num separador personalizado

Para inserir um grupo de controlo incorporado do Office num separador, adicione um elemento OfficeGroup como elemento subordinado no elemento CustomTab> principal<. O id atributo do <elemento OfficeGroup> está definido como o ID do grupo incorporado. Veja Localizar os IDs dos controlos e grupos de controlo.

O exemplo de marcação seguinte adiciona o grupo de controlo Parágrafo do Office a um separador personalizado e posiciona-o para aparecer imediatamente após um grupo personalizado.

<ExtensionPoint xsi:type="ContosoRibbonTab">
  <CustomTab id="Contoso.TabCustom1">
    <Group id="Contoso.myCustomTab.group1">
       <!-- additional markup omitted -->
    </Group>
    <OfficeGroup id="Paragraph" />
    <Label resid="customTabLabel1" />
  </CustomTab>
</ExtensionPoint>

Inserir um controlo incorporado num grupo personalizado

Para inserir um controlo incorporado do Office num grupo personalizado, adicione um elemento OfficeControl como elemento subordinado no elemento grupo> principal<. O id atributo do <elemento OfficeControl> está definido como o ID do controlo incorporado. Veja Localizar os IDs dos controlos e grupos de controlo.

O exemplo de marcação seguinte adiciona o controlo Superior à Linha do Office a um grupo personalizado e posiciona-o para aparecer imediatamente após um botão personalizado.

<ExtensionPoint xsi:type="ContosoRibbonTab">
  <CustomTab id="Contoso.TabCustom2">
    <Group id="Contoso.TabCustom2.group1">
        <Label resid="residCustomTabGroupLabel"/>
        <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 omitted. -->
        </Control>
        <OfficeControl id="Superscript" />
        <!-- Other controls, as needed. -->
    </Group>
    <Label resid="customTabLabel1" />
  </CustomTab>
</ExtensionPoint>

Observação

Os utilizadores podem personalizar o friso na aplicação do Office. Quaisquer personalizações de utilizador irão substituir as suas definições de manifesto. Por exemplo, um utilizador pode remover um botão de qualquer grupo e remover qualquer grupo de um separador.

Localizar os IDs de controlos e grupos de controlo

Os IDs dos controlos e grupos de controlo suportados estão em ficheiros nos IDs de Controlo do Office do repositório. Siga as instruções no ficheiro ReadMe desse repositório.

Comportamento em plataformas não suportadas

Se o seu suplemento estiver instalado numa plataforma que não suporta o conjunto de requisitos AddinCommands 1.3, a marcação descrita neste artigo é ignorada e os controlos/grupos incorporados do Office não serão apresentados nos seus grupos/separadores personalizados. Para impedir que o seu suplemento seja instalado em plataformas que não suportam a marcação, adicione uma referência ao conjunto de requisitos na< secção Requisitos> do manifesto. Para obter instruções, consulte Especificar que versões e plataformas do Office podem alojar o seu suplemento. Em alternativa, crie o seu suplemento para ter uma experiência quando o AddinCommands 1.3 não é suportado, conforme descrito em Estrutura para experiências alternativas. Por exemplo, se o seu suplemento contiver instruções que partem do princípio de que os botões incorporados estão nos seus grupos personalizados, pode estruturar uma versão que pressupõe que os botões incorporados estão apenas nos locais habituais.