Compartir a través de

Elemento CustomTab

  • Artículo

Define una pestaña personalizada para la cinta de Office. Agregue controles y grupos de cinta de opciones para el complemento a una de las pestañas de Office de compilación o a su propia pestaña personalizada. Use el <elemento CustomTab> para agregar una pestaña personalizada a la cinta de opciones. En las pestañas personalizadas, el complemento puede tener grupos personalizados o integrados. Los complementos están limitados a una pestaña personalizada.

Importante

En Outlook en Mac, el <elemento CustomTab> no está disponible, pero puede colocar grupos personalizados de controles en uno de los OfficeTabintegrados en su lugar. No puede colocar grupos integrados en pestañas integradas en Outlook en ninguna plataforma.

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 de solo complemento.

Nota:

Algunos elementos secundarios no son válidos en los esquemas mail. Consulte Elementos secundarios.

Asociado a estos conjuntos de requisitos:

Atributos

Atributo Obligatorio Descripción
id Yes Un identificador único para la pestaña personalizada.

Atributo id

Obligatorio. Identificador único de la pestaña personalizada. Es una cadena con un máximo de 125 caracteres. Debe ser único en el manifiesto.

Elementos secundarios

Elemento Obligatorio Descripción
Group No Define un grupo de comandos.
OfficeGroup No Representa un grupo de control de Office integrado. Importante: No está disponible en Outlook.
Label Yes Etiqueta de CustomTab.
InsertAfter No Especifica que la pestaña personalizada debe estar inmediatamente después de una pestaña de Office integrada especificada. Importante: Solo está disponible en PowerPoint.
InsertBefore No Especifica que la pestaña personalizada debe estar inmediatamente antes de una pestaña de Office integrada especificada. Importante: Solo está disponible en PowerPoint.

Group

Opcional, pero si no está presente debe haber al menos un <elemento OfficeGroup> . Consulte elemento Group. El orden de <Group> y <OfficeGroup> en el manifiesto debe ser el orden en el que desea que aparezcan en la pestaña personalizada. Se pueden intercalar si hay varios elementos, pero todos deben estar por encima del <elemento Label> .

OfficeGroup

Opcional, pero si no está presente debe haber al menos un <elemento Group> . Representa un grupo de control de Office integrado. El atributo id especifica el identificador del grupo integrado de Office. Para buscar el identificador de un grupo integrado, consulte Búsqueda de los identificadores de controles y grupos de controles. El orden de <Group> y <OfficeGroup> en el manifiesto debe ser el orden en el que desea que aparezcan en la pestaña personalizada. Se pueden intercalar si hay varios elementos, pero todos deben estar por encima del <elemento Label> .

Importante

El <elemento OfficeGroup> no está disponible en Outlook. En PowerPoint, está en versión preliminar para Mac y Windows; pero está disponible para complementos de producción en PowerPoint en la web.

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 de solo complemento.

Asociado a estos conjuntos de requisitos:

Etiqueta (pestaña)

Obligatorio. Etiqueta de la pestaña personalizada. 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 .

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 de solo complemento.

Asociado a estos conjuntos de requisitos:

InsertAfter

Opcional. Especifica que la pestaña personalizada debe estar inmediatamente después de una pestaña de Office integrada especificada. El valor del elemento es el identificador de la pestaña integrada, como TabHome o TabReview. Para obtener una lista de pestañas integradas, vea OfficeTab. Si está presente, debe estar después del <elemento Label> . No puede tener Tanto InsertAfter> como<<InsertBefore>.

Importante

El <elemento InsertAfter> solo está disponible en PowerPoint.

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 de solo complemento.

Asociado a estos conjuntos de requisitos:

InsertBefore

Opcional. Especifica que la pestaña personalizada debe estar inmediatamente antes de una pestaña de Office integrada especificada. El valor del elemento es el identificador de la pestaña integrada, como TabHome o TabReview. El valor del elemento es el identificador de la pestaña integrada, como TabHome o TabReview. Para obtener una lista de pestañas integradas, vea OfficeTab. Si está presente, debe estar después del <elemento Label> . No puede tener Tanto InsertAfter> como<<InsertBefore>.

Importante

El <elemento InsertBefore> solo está disponible en PowerPoint.

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 de solo complemento.

Asociado a estos conjuntos de requisitos:

Ejemplos

En el siguiente ejemplo de marcado se agrega el grupo de control Párrafo de Office a una pestaña personalizada y se coloca para que aparezca justo después de un 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>

En el siguiente ejemplo de marcado se agrega el control Superscript de Office a un grupo personalizado y se coloca para que aparezca justo después de un botón 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>