Elemento Group

Define um grupo de controles de interface do usuário em uma guia. Em guias personalizadas, o suplemento pode criar vários grupos. Os suplementos estão limitados a uma guia personalizada.

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:

• 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. Isso deve ser exclusivo em todos os elementos do Grupo no manifesto.

Elementos filho

Elemento	Obrigatório	Descrição
Label	Sim	O rótulo de um grupo.
Icon	Sim	A imagem de um grupo. Não há suporte em suplementos do Outlook.
Control	Não	Representa um objeto Control. Pode ser zero ou mais.
OfficeControl	Não	Representa um dos controles internos do Office. Pode ser zero ou mais. Com suporte apenas em suplementos do PowerPoint.
OverriddenByRibbonApi	Não	Especifica se o grupo deve aparecer em combinações de aplicativo e plataforma que dão suporte a guias contextuais personalizadas. Não há suporte em suplementos do Outlook.

Rótulo

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

Ícone

Obrigatório. Se uma guia contiver muitos grupos e a janela do programa for redimensionada, a imagem especificada poderá ser exibida.

Observação

Esse elemento filho não tem suporte nos suplementos do Outlook.

Controle

Opcional, mas se não estiver presente, deve haver pelo menos um <OfficeControl>. Para obter detalhes sobre os tipos de controles com suporte, consulte o elemento Controle . A ordem de <Controle> e <OfficeControl> no manifesto é intercambiável e elas podem ser intercaladas se houver vários elementos, mas todos devem estar abaixo do <elemento Icon> .

<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, deve haver pelo menos um <Controle>. Inclua um ou mais controles internos do Office no grupo com <elementos do OfficeControl> . O id atributo especifica a ID do controle interno do Office. Para encontrar a ID de um controle, consulte Localizar as IDs de controles e grupos de controle. A ordem de <Controle> e <OfficeControl> no manifesto é intercambiável e elas podem ser intercaladas se houver vários elementos, mas todos devem estar abaixo do <elemento Icon> .

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:

• AddinCommands 1.3

Observação

Esse elemento filho só tem suporte 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 (booliano). Especifica se o <Grupo> estará oculto em combinações de aplicativo e plataforma que dão suporte a uma API que instala uma guia contextual personalizada na faixa de opções no runtime. O valor padrão, se não estiver presente, é false. Se usado, <OverriddenByRibbonApi> deve ser o primeiro filho do <Grupo>. Para obter mais informações, consulte OverriddenByRibbonApi.

Observação

Esse elemento filho não tem suporte 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>