Compartilhar via

Elemento CustomTab

  • Artigo

Define um separador personalizado para o friso do Office. Adicione controlos e grupos do friso para o suplemento a um dos separadores do Office incorporados ou ao seu próprio separador personalizado. Utilize o <elemento CustomTab> para adicionar um separador personalizado ao friso. Nos separadores personalizados, o suplemento pode ter grupos personalizados ou incorporados. Os suplementos estão limitados a uma guia personalizada.

Importante

No Outlook para Mac, o <elemento CustomTab> não está disponível, mas pode colocar grupos de controlos personalizados num dos OfficeTabsincorporados. Não pode colocar grupos incorporados em separadores incorporados no Outlook em nenhuma plataforma.

Tipo de suplemento: Painel de tarefas, Correio

Válido apenas nestes esquemas VersionOverrides:

  • Painel de tarefas 1.0
  • Email 1.0
  • Email 1.1

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

Observação

Alguns elementos subordinados não são válidos nos esquemas de Correio. Veja Elementos subordinados.

Associados a estes conjuntos de requisitos:

Atributos

Atributo Obrigatório Descrição
id Sim Um ID exclusivo para o separador personalizado.

id attribute

Obrigatório. Identificador exclusivo do separador personalizado. É uma cadeia com um máximo de 125 carateres. Tem de ser exclusivo no manifesto.

Elementos filho

Elemento Obrigatório Descrição
Group Não Define um grupo de comandos
OfficeGroup Não Representa um grupo de controlo incorporado do Office. Importante: não disponível no Outlook.
Label Sim A etiqueta do CustomTab.
InsertAfter Não Especifica que o separador personalizado deve ser imediatamente após um separador incorporado do Office especificado. Importante: apenas disponível no PowerPoint.
InsertBefore Não Especifica que o separador personalizado deve ser imediatamente apresentado antes de um separador incorporado do Office especificado. Importante: apenas disponível no PowerPoint.

Group

Opcional, mas se não estiver presente, tem de existir, pelo menos, um <elemento do OfficeGroup> . Confira Elemento Group A ordem de <Grupo> e <OfficeGroup> no manifesto deve ser a ordem pela qual pretende que apareçam no separador personalizado. Podem ser intercalados se existirem vários elementos, mas todos têm de estar acima do <elemento Etiqueta> .

OfficeGroup

Opcional, mas se não estiver presente, tem de existir, pelo menos, um <elemento Grupo> . Representa um grupo de controlo incorporado do Office. O atributo ID especifica o ID do grupo incorporado do Office. Para localizar o ID de um grupo incorporado, veja Localizar os IDs dos controlos e grupos de controlo. A ordem de <Grupo> e <OfficeGroup> no manifesto deve ser a ordem pela qual pretende que apareçam no separador personalizado. Podem ser intercalados se existirem vários elementos, mas todos têm de estar acima do <elemento Etiqueta> .

Importante

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

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:

Label (Tab)

Obrigatório. A etiqueta do separador personalizado. O atributo resid não pode ter mais de 32 carateres e tem de ser definido para o valor do atributo id de um <elemento String> no <elemento ShortStrings> no elemento Resources .

Tipo de suplemento: Painel de tarefas, Correio

Válido apenas nestes esquemas VersionOverrides:

  • Painel de tarefas 1.0
  • Email 1.0
  • Email 1.1

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

Associados a estes conjuntos de requisitos:

InsertAfter

Opcional. Especifica que o separador personalizado deve ser imediatamente após um separador incorporado do Office especificado. O valor do elemento é o ID do separador incorporado, como TabHome ou TabReview. Para obter uma lista de separadores incorporados, consulte OfficeTab. Se estiver presente, tem de estar a seguir ao <elemento Label> . 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 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:

InsertBefore

Opcional. Especifica que o separador personalizado deve ser imediatamente apresentado antes de um separador incorporado do Office especificado. O valor do elemento é o ID do separador incorporado, como TabHome ou TabReview. O valor do elemento é o ID do separador incorporado, como TabHome ou TabReview. Para obter uma lista de separadores incorporados, consulte OfficeTab. Se estiver presente, tem de estar a seguir ao <elemento Label> . 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 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:

Exemplos

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

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