Personalizar una cinta de opciones para Outlook

Al personalizar la cinta en Microsoft Office Outlook, debe tener en cuenta dónde aparecerá la cinta personalizada en la aplicación. Outlook muestra la cinta en la interfaz de usuario (UI) de la aplicación principal y en las ventanas que se abren cuando los usuarios realizan ciertas tareas, como crear mensajes de correo electrónico. Estas ventanas de la aplicación se denominan inspectores.

Se aplica a: La información de este tema se aplica a los proyectos de complementos de VSTO para Outlook. Para obtener más información, consulte Características disponibles por aplicación de Office lication y tipo de proyecto.

Adición de una cinta de opciones personalizada a la interfaz de usuario de la aplicación principal

La interfaz de usuario de la aplicación principal en Outlook se denomina Explorador. Si usa el elemento Cinta de opciones (Diseñador visual), puede agregar una cinta al Explorador haciendo clic en la propiedad RibbonType de la cinta de opciones en la ventana Propiedades y, a continuación, seleccionando Microsoft.Outlook.Explorer.

Asignar una cinta de opciones a un inspector

Para identificar el inspector que desea personalizar, debe especificar el tipo de cinta que corresponde a la clase de mensaje del Inspector.

Si usa el elemento Ribbon (Visual Designer), haga clic en la propiedad RibbonType de la cinta de opciones en la ventana Propiedades y, a continuación, seleccione uno o varios identificadores de cinta de opciones en la lista de valores.

Puede agregar más de una cinta a un proyecto. Si más de una cinta comparte el mismo identificador de cinta, reemplace el método CreateRibbonExtensibilityObject de la clase ThisAddin de su proyecto para especificar qué cinta se mostrará en tiempo de ejecución. Para obtener más información, consulte Introducción a la cinta de opciones. Para obtener más información sobre cada tipo de cinta de opciones, vea el artículo técnico Personalizar la cinta de opciones en Outlook 2007.

Especificar el tipo de cinta mediante XML de la cinta de opciones

Si usa el elemento Ribbon (XML), compruebe el valor del parámetro ribbonID en el GetCustomUI método y devuelva la cinta de opciones adecuada.

Visual Studio genera automáticamente el método GetCustomUI en el archivo de código de la cinta. El parámetro ribbonID es una cadena que identifica el Explorador o un tipo específico de inspector. Para obtener una lista completa de los posibles valores del parámetro ribbonID , consulte el artículo técnico Personalizar la cinta de opciones en Outlook 2007.

En el siguiente ejemplo de código se indica cómo mostrar una cinta personalizada únicamente en el inspector Microsoft.Outlook.Mail.Compose. Este es el inspector que se abre cuando un usuario crea un nuevo mensaje de correo electrónico. La cinta de opciones que se va a mostrar se especifica en el GetResourceText() método , que se genera en la clase Ribbon . Para obtener más información sobre la clase Ribbon , vea Xml de la cinta de opciones.

public string GetCustomUI(string ribbonID)
{
    string ribbonXML = String.Empty;

    if (ribbonID == "Microsoft.Outlook.Mail.Compose")
    {
        ribbonXML = GetResourceText("Trin_RibbonOutlookBasic.Ribbon1.xml");
    }

    return ribbonXML;
}