Integrar botões internos do Office em grupos e guias de controle personalizados

Você pode inserir botões internos do Office em seus grupos de controle personalizados na faixa de opções do Office usando marcação no manifesto do suplemento. (Você não pode inserir seus comandos de suplemento personalizados em um grupo interno do Office.) Você também pode inserir grupos de controle internos do Office em suas guias de faixa de opções personalizadas.

Observação

Este artigo pressupõe que você esteja familiarizado com o artigo Conceitos básicos para comandos de suplemento. Examine se você não fez isso recentemente.

Importante

• O recurso de suplemento e a marcação descritos neste artigo só estão disponíveis em PowerPoint na Web, no Windows e no Mac.
• A marcação descrita neste artigo funciona apenas em plataformas que dão suporte ao conjunto de requisitos AddinCommands 1.3. Consulte a seção posterior Comportamento em plataformas sem suporte.

Inserir um grupo de controle interno em uma guia personalizada

Para inserir um grupo de controle interno do Office em uma guia, adicione um elemento OfficeGroup como um elemento filho no elemento CustomTab> pai<. O id atributo do elemento <OfficeGroup> é definido como a ID do grupo interno. Consulte Localizar as IDs de controles e grupos de controle.

O exemplo de marcação a seguir adiciona o grupo de controle Parágrafo do Office a uma guia personalizada e o posiciona para aparecer logo 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 controle interno em um grupo personalizado

Para inserir um controle interno do Office em um grupo personalizado, adicione um elemento OfficeControl como um elemento filho no elemento Grupo> pai<. O id atributo do <elemento OfficeControl> é definido como a ID do controle interno. Consulte Localizar as IDs de controles e grupos de controle.

O exemplo de marcação a seguir adiciona o controle Do Office Superscript a um grupo personalizado e o posiciona para aparecer logo 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 usuários podem personalizar a faixa de opções no aplicativo do Office. Todas as personalizações de usuário substituirão suas configurações de manifesto. Por exemplo, um usuário pode remover um botão de qualquer grupo e remover qualquer grupo de uma guia.

Localizar as IDs de controles e grupos de controle

As IDs para controles com suporte e grupos de controle estão em arquivos nas IDs de controle do Office de repositório. Siga as instruções no arquivo ReadMe desse repositório.

Comportamento em plataformas sem suporte

Se o suplemento estiver instalado em uma plataforma que não dá suporte ao conjunto de requisitos AddinCommands 1.3, a marcação descrita neste artigo será ignorada e os controles/grupos internos do Office não aparecerão em seus grupos/guias personalizados. Para impedir que seu suplemento seja instalado em plataformas que não dão suporte à marcação, adicione uma referência ao requisito definido na <seção Requisitos> do manifesto. Para obter instruções, consulte Especificar quais versões e plataformas do Office podem hospedar seu suplemento. Como alternativa, crie seu suplemento para ter uma experiência quando o AddinCommands 1.3 não tiver suporte, conforme descrito em Design para experiências alternativas. Por exemplo, se o suplemento contiver instruções que pressupõem que os botões internos estejam em seus grupos personalizados, você poderá projetar uma versão que pressupõe que os botões internos estejam apenas em seus lugares habituais.