Colocar una pestaña personalizada en la cinta de opciones

Puede especificar dónde desea que aparezca la pestaña personalizada del complemento en la cinta de opciones de la aplicación de Office mediante el marcado en el manifiesto del complemento.

Especifique dónde desea que aparezca una pestaña personalizada mediante la identificación de la pestaña integrada de Office a la que desea que esté junto y especificando si debe estar en el lado izquierdo o derecho de la pestaña integrada. Para realizar estas especificaciones, incluya un elemento InsertBefore (izquierda) o InsertAfter (derecha) en el elemento CustomTab del manifiesto del complemento. (No puede tener ambos elementos).

En el ejemplo siguiente, la pestaña personalizada está configurada para que aparezca justo después de la pestaña Revisar . Tenga en cuenta que el valor del <elemento InsertAfter> es el identificador de la pestaña integrada de Office.

<ExtensionPoint xsi:type="ContosoRibbonTab">
  <CustomTab id="Contoso.TabCustom2">
    <Group id="Contoso.TabCustom2.group2">
       <!-- additional markup omitted -->
    </Group>
    <Label resid="customTabLabel1" />
    <InsertAfter>TabReview</InsertAfter>
  </CustomTab>
</ExtensionPoint>

Tenga en cuenta los siguientes puntos.

• Los <elementos InsertBefore> e <InsertAfter> son opcionales. Si no usa ninguna, la pestaña personalizada aparecerá como la pestaña situada más a la derecha en la cinta de opciones.
• Los <elementos InsertBefore> e <InsertAfter> son mutuamente excluyentes. No se pueden usar ambas.
• Si el usuario instala más de un complemento cuya pestaña personalizada está configurada para el mismo lugar, por ejemplo, después de la pestaña Revisar , la pestaña del complemento instalado más recientemente se ubicará en ese lugar. Las pestañas de los complementos instalados anteriormente se moverán sobre un solo lugar. Por ejemplo, el usuario instala los complementos A, B y C en ese orden y todos están configurados para insertar una pestaña después de la pestaña Revisar , las pestañas aparecerán en este orden: Review, AddinCTab, AddinBTab, AddinATab.
• Los usuarios pueden personalizar la cinta de opciones en la aplicación de Office. Por ejemplo, un usuario puede mover u ocultar la pestaña del complemento. No se puede evitar esto ni detectar que se ha producido.
• Si un usuario mueve una de las pestañas integradas, Office interpreta los <elementos InsertBefore> e <InsertAfter> en términos de la ubicación predeterminada de la pestaña integrada. Por ejemplo, si el usuario mueve la pestaña Revisar al extremo derecho de la cinta de opciones, Office interpretará el marcado del ejemplo anterior como "colocar la pestaña personalizada a la derecha de donde estaría la pestaña Revisar de forma predeterminada".

Especificar qué pestaña tiene el foco cuando se abre el documento

Office siempre proporciona el foco predeterminado a la pestaña que está inmediatamente a la derecha de la pestaña Archivo . De forma predeterminada, esta es la pestaña Inicio . Si configura la pestaña personalizada para que esté antes de la pestaña Inicio , con <InsertBefore>TabHome</InsertBefore>, la pestaña personalizada tendrá el foco cuando se abra el documento.

Comportamiento en plataformas no admitidas

Si el complemento está instalado en una plataforma que no admite el conjunto de requisitos AddinCommands 1.3, se omite el marcado descrito en este artículo y la pestaña personalizada aparecerá como la pestaña más a la derecha de la cinta de opciones. Para evitar que el complemento se instale en plataformas que no admiten el marcado, agregue una referencia al conjunto de requisitos en la <sección Requisitos> del manifiesto. Para obtener instrucciones, vea Especificar qué versiones y plataformas de Office pueden hospedar el complemento. Como alternativa, diseñe el complemento para que tenga una experiencia alternativa cuando no se admita AddinCommands 1.3 , como se describe en Diseño para experiencias alternativas. Por ejemplo, si el complemento contiene instrucciones que suponen que la pestaña personalizada es la que quiere, podría tener una versión alternativa que suponga que la pestaña es la más adecuada.