Elemento Group

Define um grupo de controlos de IU num separador. Nos separadores personalizados, o suplemento pode criar vários grupos. Os suplementos estão limitados a uma guia personalizada.

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:

• AddinCommands 1.1

Atributos

Atributo	Obrigatório	Descrição
id	Sim	Identificação exclusiva do grupo.

id attribute

Obrigatório. O identificador exclusivo do grupo. É uma cadeia de caracteres com, no máximo, 125 caracteres. Tem de ser exclusivo em todos os elementos do Grupo no manifesto.

Elementos filho

Elemento	Obrigatório	Descrição
Label	Sim	A etiqueta de um grupo.
Icon	Sim	A imagem de um grupo. Não suportado nos suplementos do Outlook.
Control	Não	Representa um objeto De controlo. Pode ser zero ou mais.
OfficeControl	Não	Representa um dos controlos incorporados do Office. Pode ser zero ou mais. Suportado apenas em suplementos do PowerPoint.
OverriddenByRibbonApi	Não	Especifica se o grupo deve aparecer nas combinações de aplicações e plataformas que suportam separadores contextuais personalizados. Não suportado nos suplementos do Outlook.

Rótulo

Obrigatório. O rótulo do grupo. 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 .

Ícone

Obrigatório. Se um separador contiver muitos grupos e a janela do programa for redimensionada, a imagem especificada poderá ser apresentada.

Observação

Este elemento subordinado não é suportado nos suplementos do Outlook.

Control

Opcional, mas se não estiver presente, tem de existir, pelo menos, um <OfficeControl>. Para obter detalhes sobre os tipos de controlos suportados, veja o elemento Controlo . A ordem de <Controlo> e <OfficeControl> no manifesto é intercambiável e podem ser intercaladas se existirem vários elementos, mas todos têm de estar abaixo do <elemento Ícone> .

<Group id="Contoso.CustomTab1.group1">
    <Label resid="CustomTabGroupLabel"/>
    <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 -->
    </Control>
    <!-- other controls, as needed -->
</Group>

OfficeControl

Opcional, mas se não estiver presente, tem de existir, pelo menos, um <Controlo>. Inclua um ou mais controlos incorporados do Office no grupo com <elementos do OfficeControl> . O id atributo especifica o ID do controlo incorporado do Office. Para localizar o ID de um controlo, veja Localizar os IDs dos controlos e grupos de controlo. A ordem de <Controlo> e <OfficeControl> no manifesto é intercambiável e podem ser intercaladas se existirem vários elementos, mas todos têm de estar abaixo do <elemento Ícone> .

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:

• AddinCommands 1.3

Observação

Este elemento subordinado é suportado apenas em suplementos do PowerPoint.

<Group id="Contoso.CustomTab2.group2">
    <Label resid="CustomTabGroupLabel"/>
    <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 -->
    </Control>
    <OfficeControl id="Superscript" />
    <!-- other controls, as needed -->
</Group>

OverriddenByRibbonApi

Opcional (booleano). Especifica se o <Grupo> será ocultado nas combinações de aplicações e plataformas que suportam uma API que instala um separador contextual personalizado no friso no runtime. O valor predefinido, se não estiver presente, é false. Se utilizado, <OverriddenByRibbonApi> tem de ser o primeiro subordinado de <Grupo>. Para obter mais informações, veja OverriddenByRibbonApi.

Observação

Este elemento subordinado não é suportado nos suplementos do Outlook.

<ExtensionPoint xsi:type="PrimaryCommandSurface">
  <CustomTab id="Contoso.CustomTab">
    <Group id="Contoso.CustomTab.group1">
      <OverriddenByRibbonApi>true</OverriddenByRibbonApi>
      <!-- other child elements of the group -->
    </Group>
    <Label resid="customTabLabel"/>
  </CustomTab>
</ExtensionPoint>