Posicione uma guia personalizada sobre a faixa de opções

Você pode especificar onde deseja que a guia personalizada do suplemento apareça na faixa de opções do aplicativo do Office usando marcação no manifesto do suplemento.

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.
• A marcação descrita neste artigo funciona apenas em plataformas que dão suporte ao conjunto de requisitos AddinCommands 1.3. Confira Comportamento em plataformas sem suporte abaixo.

Especifique onde você deseja que uma guia personalizada apareça identificando qual guia interna do Office deseja que ela esteja ao lado e especificando se ela deve estar no lado esquerdo ou direito da guia interna. Faça essas especificações incluindo um elemento InsertBefore (esquerda) ou InsertAfter (direita) no elemento CustomTab do manifesto do suplemento. (Você não pode ter ambos os elementos.)

No exemplo a seguir, a guia personalizada é configurada para ser exibida logo após a guia Examinar . Observe que o valor do <elemento InsertAfter> é a ID da guia interna do Office.

<ExtensionPoint xsi:type="ContosoRibbonTab">
  <CustomTab id="Contoso.TabCustom2">
    <Group id="Contoso.TabCustom2.group2">
       <!-- additional markup omitted -->
    </Group>
    <Label resid="customTabLabel1" />
    <InsertAfter>TabReview</InsertAfter>
  </CustomTab>
</ExtensionPoint>

Lembre-se dos pontos a seguir.

• Os <elementos InsertBefore> e <InsertAfter> são opcionais. Se você não usar nenhum dos dois, sua guia personalizada aparecerá como a guia mais à direita na faixa de opções.
• Os <elementos InsertBefore> e <InsertAfter> são mutuamente exclusivos. Você não pode usar ambos.
• Se o usuário instalar mais de um suplemento cuja guia personalizada está configurada para o mesmo local, por exemplo, após a guia Examinar , a guia do suplemento instalado mais recentemente estará localizada nesse local. As guias dos suplementos instalados anteriormente serão movidas em um só lugar. Por exemplo, o usuário instala suplementos A, B e C nessa ordem e todos estão configurados para inserir uma guia após a guia Revisão e, em seguida, as guias serão exibidas nesta ordem: Revisão, AddinCTab, AddinBTab, AddinATab.
• Os usuários podem personalizar a faixa de opções no aplicativo do Office. Por exemplo, um usuário pode mover ou ocultar a guia do suplemento. Você não pode impedir isso ou detectar que isso aconteceu.
• Se um usuário mover uma das guias internas, o Office interpretará os <elementos InsertBefore> e <InsertAfter> em termos do local padrão da guia interna. Por exemplo, se o usuário mover a guia Revisão para a extremidade direita da faixa de opções, o Office interpretará a marcação no exemplo anterior como significando "coloque a guia personalizada à direita de onde a guia Revisão estaria por padrão".

Especificar qual guia tem foco quando o documento é aberto

O Office sempre dá foco padrão à guia que está imediatamente à direita da guia Arquivo . Por padrão, essa é a guia Página Inicial . Se você configurar sua guia personalizada para estar antes da guia Página Inicial , com <InsertBefore>TabHome</InsertBefore>, sua guia personalizada terá foco quando o documento for aberto.

Importante

Dar destaque excessivo as inconveniências do seu suplemento e incomodar os usuários e os administradores. Não posicione uma guia personalizada antes da guia Página Inicial , a menos que seu suplemento seja a principal maneira de os usuários interagirem com o documento.

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 sua guia personalizada aparecerá como a guia mais à direita na faixa de opções. 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 alternativa 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 assumem que a guia personalizada é onde você deseja, você poderá ter uma versão alternativa que pressupõe que a guia seja a mais correta.