Elemento CustomTab

  • Artigo

Define uma guia personalizada para a faixa de opções do Office. Adicione controles e grupos de faixa de opções para o suplemento a uma das guias do Office de build-in ou à sua própria guia personalizada. Use o <elemento CustomTab> para adicionar uma guia personalizada à faixa de opções. Em guias personalizadas, o suplemento pode ter grupos personalizados ou internos. Os suplementos estão limitados a uma guia personalizada.

Importante

No Outlook no Mac, o <elemento CustomTab> não está disponível, mas você pode colocar grupos personalizados de controles em um dos OfficeTabsinternos. Você não pode colocar grupos internos em guias internas no Outlook em qualquer plataforma.

Tipo de suplemento: Painel de tarefas, Email

Válido somente nestes esquemas VersionOverrides:

  • Painel de tarefas 1.0
  • Email 1.0
  • Email 1.1

Para obter mais informações, consulte Substituições de versão no manifesto.

Observação

Alguns elementos filho não são válidos nos esquemas do Mail. Consulte Elementos filho.

Associado a esses conjuntos de requisitos:

Atributos

Atributo Obrigatório Descrição
id Sim Uma ID exclusiva para a guia personalizada.

id attribute

Obrigatório. Identificador exclusivo para a guia personalizada. É uma cadeia de caracteres com no máximo 125 caracteres. Isso deve ser exclusivo dentro do manifesto.

Elementos filho

Elemento Obrigatório Descrição
Group Não Define um grupo de comandos
OfficeGroup Não Representa um grupo de controle interno do Office. Importante: não está disponível no Outlook.
Label Sim O rótulo do CustomTab.
InsertAfter Não Especifica que a guia personalizada deve ser imediatamente após uma guia interna especificada do Office. Importante: somente disponível no PowerPoint.
InsertBefore Não Especifica que a guia personalizada deve ser imediatamente antes de uma guia interna especificada do Office. Importante: somente disponível no PowerPoint.

Grupo

Opcional, mas se não estiver presente, deve haver pelo menos um <elemento OfficeGroup> . Confira Elemento Group A ordem de <Grupo> e <OfficeGroup> no manifesto deve ser a ordem que você deseja que eles apareçam na guia personalizada. Eles podem ser intercalados se houver vários elementos, mas todos devem estar acima do <elemento Label> .

OfficeGroup

Opcional, mas se não estiver presente, deve haver pelo menos um <elemento Group> . Representa um grupo de controle interno do Office. O atributo id especifica a ID do grupo interno do Office. Para encontrar a ID de um grupo interno, consulte Localizar as IDs de controles e grupos de controle. A ordem de <Grupo> e <OfficeGroup> no manifesto deve ser a ordem que você deseja que eles apareçam na guia personalizada. Eles podem ser intercalados se houver vários elementos, mas todos devem estar acima do <elemento Label> .

Importante

O <elemento OfficeGroup> não está disponível no Outlook. No PowerPoint, ele está em versão prévia para Mac e Windows; mas está disponível para suplementos de produção em PowerPoint na Web.

Tipo de suplemento: Painel de tarefas

Válido somente nestes esquemas VersionOverrides:

  • Painel de tarefas 1.0

Para obter mais informações, consulte Substituições de versão no manifesto.

Associado a esses conjuntos de requisitos:

Label (Tab)

Obrigatório. O rótulo da guia personalizada. O atributo resid não pode ter mais de 32 caracteres e deve ser definido como o valor do atributo id de um <elemento String> no <elemento ShortStrings> no elemento Resources .

Tipo de suplemento: Painel de tarefas, Email

Válido somente nestes esquemas VersionOverrides:

  • Painel de tarefas 1.0
  • Email 1.0
  • Email 1.1

Para obter mais informações, consulte Substituições de versão no manifesto.

Associado a esses conjuntos de requisitos:

InsertAfter

Opcional. Especifica que a guia personalizada deve ser imediatamente após uma guia interna especificada do Office. O valor do elemento é a ID da guia interna, como TabHome ou TabReview. Para obter uma lista de guias internas, consulte OfficeTab. Se estiver presente, deve ser após o <elemento Label> . Você não pode ter InsertAfter<> e <InsertBefore>.

Importante

O <elemento InsertAfter> só está disponível no PowerPoint.

Tipo de suplemento: Painel de tarefas

Válido somente nestes esquemas VersionOverrides:

  • Painel de tarefas 1.0

Para obter mais informações, consulte Substituições de versão no manifesto.

Associado a esses conjuntos de requisitos:

InsertBefore

Opcional. Especifica que a guia personalizada deve ser imediatamente antes de uma guia interna especificada do Office. O valor do elemento é a ID da guia interna, como TabHome ou TabReview. O valor do elemento é a ID da guia interna, como TabHome ou TabReview. Para obter uma lista de guias internas, consulte OfficeTab. Se estiver presente, deve ser após o <elemento Label> . Você não pode ter InsertAfter<> e <InsertBefore>.

Importante

O <elemento InsertBefore> só está disponível no PowerPoint.

Tipo de suplemento: Painel de tarefas

Válido somente nestes esquemas VersionOverrides:

  • Painel de tarefas 1.0

Para obter mais informações, consulte Substituições de versão no manifesto.

Associado a esses conjuntos de requisitos:

Exemplos

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.TabCustom">
    <Group id="Contoso.TabCustom1.group1">
       <!-- additional markup omitted -->
    </Group>
    <OfficeGroup id="Paragraph" />
    <Label resid="customTabLabel1" />
  </CustomTab>
</ExtensionPoint>

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.TabCustom">
    <Group id="Contoso.TabCustom2.group2">
        <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.Button2">
            <!-- information on the control omitted -->
        </Control>
        <OfficeControl id="Superscript" />
        <!-- other controls, as needed -->
    </Group>
    <Label resid="customTabLabel1" />
  </CustomTab>
</ExtensionPoint>