Elemento Group

  • Artículo

Define un grupo de controles de interfaz de usuario en una pestaña. En las pestañas personalizadas, el complemento puede crear varios grupos. Los complementos están limitados a una pestaña personalizada.

Tipo de complemento: Panel de tareas, Correo

Solo es válido en estos esquemas VersionOverrides:

  • Panel de tareas 1.0
  • Correo 1.0
  • Correo 1.1

Para obtener más información, vea Invalidaciones de versión en el manifiesto.

Asociado a estos conjuntos de requisitos:

Atributos

Atributo Obligatorio Descripción
id Sí Un identificador único para el grupo.

Atributo id

Necesario. Identificador único para el grupo. Es una cadena con un máximo de 125 caracteres. Debe ser único en todos los elementos Group del manifiesto.

Elementos secundarios

Elemento Obligatorio Descripción
Label Sí Etiqueta de un grupo.
Icon Yes Imagen de un grupo. No se admite en complementos de Outlook.
Control No Representa un objeto Control. Puede ser cero o más.
OfficeControl No Representa uno de los controles integrados de Office. Puede ser cero o más. Solo se admite en complementos de PowerPoint.
OverriddenByRibbonApi No Especifica si el grupo debe aparecer en las combinaciones de aplicaciones y plataformas que admiten pestañas contextuales personalizadas. No se admite en complementos de Outlook.

Etiqueta

Obligatorio. La etiqueta del grupo. El atributo resid no puede tener más de 32 caracteres y debe establecerse en el valor del atributo id de un <elemento String> en el <elemento ShortStrings> del elemento Resources .

Icono

Necesario. Si una pestaña contiene una gran cantidad de grupos y se cambia el tamaño de la ventana del programa, la imagen especificada puede mostrarse en su lugar.

Nota:

Este elemento secundario no se admite en los complementos de Outlook.

Control

Opcional, pero si no está presente debe haber al menos un <OfficeControl>. Para obtener más información sobre los tipos de controles que se admiten, vea el elemento Control . El orden de <Control> y <OfficeControl> en el manifiesto es intercambiable y se pueden intercalar si hay varios elementos, pero todos deben estar por debajo del <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, pero si no está presente debe haber al menos un <control>. Incluya uno o varios controles de Office integrados en el grupo con <elementos OfficeControl> . El id atributo especifica el identificador del control integrado de Office. Para buscar el identificador de un control, consulte Búsqueda de los identificadores de controles y grupos de controles. El orden de <Control> y <OfficeControl> en el manifiesto es intercambiable y se pueden intercalar si hay varios elementos, pero todos deben estar por debajo del <elemento Icon> .

Tipo de complemento: Panel de tareas

Solo es válido en estos esquemas VersionOverrides:

  • Panel de tareas 1.0

Para obtener más información, vea Invalidaciones de versión en el manifiesto.

Asociado a estos conjuntos de requisitos:

Nota:

Este elemento secundario solo se admite en complementos de 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 si el <grupo> se ocultará en las combinaciones de aplicaciones y plataformas que admiten una API que instala una pestaña contextual personalizada en la cinta de opciones en tiempo de ejecución. El valor predeterminado, si no está presente, es false. Si se usa, <OverriddenByRibbonApi> debe ser el primer elemento secundario de <Group>. Para obtener más información, vea OverriddenByRibbonApi.

Nota:

Este elemento secundario no se admite en los complementos de 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>