Personalizar una cinta de opciones para OutlookCustomizing a Ribbon for Outlook

Al personalizar la cinta en Microsoft Office Outlook, debe tener en cuenta dónde aparecerá la cinta personalizada en la aplicación.When you customize the ribbon in Microsoft Office Outlook, you must consider where your custom ribbon will appear in the application. 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.Outlook displays the ribbon in the main application user interface (UI) and in windows that open when users perform certain tasks, such as creating e-mail messages. Estas ventanas de la aplicación se denominan inspectores.These application windows are named inspectors.

vínculo a vídeo para una demostración en vídeo relacionada, vea Cómo: usar el Diseñador de la cinta de opciones para personalizar la cinta de opciones en Outlook?.link to video For a related video demonstration, see How Do I: Use the Ribbon Designer to Customize the Ribbon in Outlook?.

Aplicación: la información de este tema se aplica a los proyectos de complemento de VSTO para Outlook.Applies to: The information in this topic applies to VSTO add-in projects for Outlook. Para obtener más información, consulte Características disponibles por aplicación y tipo de proyecto de Office.For more information, see Features Available by Office Application and Project Type.

Agregar una Cinta personalizada a la interfaz de usuario de la aplicación principalAdding a Custom Ribbon to the Main Application UI

La interfaz de usuario de la aplicación principal en Outlook se denomina Explorador.The main application UI in Outlook is called the Explorer. Si usas el cinta (diseñador Visual) producto, puede agregar una cinta de opciones al explorador haciendo clic en el RibbonType propiedad de la cinta de opciones en la propiedades ventana, y, a continuación, seleccione Microsoft.Outlook.Explorer.If you are using the Ribbon (Visual Designer) item, you can add a ribbon to the Explorer by clicking the RibbonType property of the ribbon in the Properties window, and then selecting Microsoft.Outlook.Explorer.

Asignar una cinta a un InspectorAssigning a Ribbon to an Inspector

Para identificar el inspector que desea personalizar, debe especificar el tipo de cinta que corresponde a la clase de mensaje del Inspector.You identify the inspector you want to customize by specifying the ribbon type that corresponds to the message class for the Inspector.

Si usas el cinta (diseñador Visual) de elemento, haga clic en el RibbonType propiedad de la cinta de opciones en la propiedades ventana y, a continuación, seleccione uno o varios identificadores de la cinta de opciones la lista de valores.If you are using the Ribbon (Visual Designer) item, click the RibbonType property of the ribbon in the Properties window, and then select one or more ribbon IDs from the list of values.

Puede agregar más de una cinta a un proyecto.You can add more than one ribbon to a project. Si más de una cinta comparte el mismo identificador de cinta, invalide el método CreateRibbonExtensibilityObject en la ThisAddin clase de su proyecto para especificar qué cinta se mostrará en tiempo de ejecución.If more than one ribbon shares a ribbon ID, override the CreateRibbonExtensibilityObject method in the ThisAddin class of your project to specify which ribbon to display at run time. Para obtener más información, consulte información general de la cinta de opciones.For more information, see Ribbon Overview. Para obtener más información acerca de cada tipo de cinta de opciones, consulte el artículo técnico personalizar la cinta en Outlook 2007.For more information about each ribbon type, see the technical article Customizing the Ribbon in Outlook 2007.

Especificar el Tipo de Cinta mediante código XML de CintaSpecifying the Ribbon Type by Using Ribbon XML

Si usas el cinta (XML) item, compruebe el valor de la ribbonID parámetro en el Microsoft.Office.Core.IRibbonExtensibility.GetCustomUI* método y devuelva la cinta adecuada.If you are using the Ribbon (XML) item, check the value of the ribbonID parameter in the Microsoft.Office.Core.IRibbonExtensibility.GetCustomUI* method and return the appropriate ribbon.

Visual Studio genera automáticamente el método Microsoft.Office.Core.IRibbonExtensibility.GetCustomUI* en el archivo de código de la cinta.The Microsoft.Office.Core.IRibbonExtensibility.GetCustomUI* method is automatically generated by Visual Studio in the ribbon code file. El ribbonID parámetro es una cadena que identifica el explorador o un tipo específico de inspector.The ribbonID parameter is a string that identifies the Explorer or a specific type of inspector. Para obtener una lista completa de los valores posibles de la ribbonID parámetro, consulte el artículo técnico personalizar la cinta en Outlook 2007.For a complete list of the possible values of the ribbonID parameter, see the technical article Customizing the Ribbon in 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.The following code example demonstrates how to display a custom ribbon only in the Microsoft.Outlook.Mail.Compose inspector. Este es el inspector que se abre cuando un usuario crea un nuevo mensaje de correo electrónico.This is the inspector that opens when a user creates a new e-mail message. La cinta de opciones para mostrar se especifica en el GetResourceText() método, que se genera en el cinta clase.The ribbon to display is specified in the GetResourceText() method, which is generated in the Ribbon class. Para obtener más información sobre la cinta de clases, vea XML de cinta de opciones.For more information about the Ribbon class, see Ribbon XML.

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

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

    return ribbonXML;
}
Public Function GetCustomUI(ByVal ribbonID As String) As String _
    Implements Office.IRibbonExtensibility.GetCustomUI

    Dim ribbonXML As String = String.Empty

    If ribbonID = "Microsoft.Outlook.Mail.Compose" Then
        ribbonXML = GetResourceText("Trin_RibbonOutlookBasic.Ribbon1.xml")
    End If

    Return ribbonXML
End Function

Vea tambiénSee Also

Accessing the Ribbon at Run Time Accessing the Ribbon at Run Time
Información general de la cinta de opciones Ribbon Overview
Diseñador de la cinta Ribbon Designer
XML de la cintaRibbon XML