Personalizar una Cinta de opciones para Outlook
Actualización: noviembre 2007
Se aplica a |
|---|
La información de este tema sólo se aplica a los proyectos y versiones especificados de Visual Studio Tools para Office de Microsoft Office. Tipo de proyecto
Versión de Microsoft Office
Para obtener más información, vea Características disponibles por aplicación y tipo de proyecto. |
Cuando personaliza la cinta de opciones en Microsoft Office Outlook 2007, debe considerar dónde aparecerá la cinta personalizada en la aplicación. Outlook no muestra la cinta de opciones en la interfaz de usuario principal de la aplicación. En su lugar, muestra la cinta de opciones 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.
Asignar una cinta de opciones a un inspector
Para identificar el inspector que desea personalizar, debe especificar el tipo de cinta de opciones que corresponde a la clase de mensaje del inspector. Los pasos para especificar el tipo de la cinta de opciones dependen de si utiliza el diseñador de la cinta de opciones o XML de la cinta de opciones.
Utilizar el diseñador de la cinta de opciones
Si utiliza el elemento Cinta (diseñador visual), 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 en la lista de valores.
Puede agregar más de una cinta de opciones a un proyecto. Si varias cintas de opciones comparten un identificador de cinta, invalide el método CreateRibbonExtensibilityObject de la clase ThisAddin del proyecto para especificar la cinta de opciones que se mostrará en tiempo de ejecución.
Para obtener más información, vea Información general sobre la cinta de opciones.
Para obtener más información sobre cada tipo de cinta de opciones, vea el artículo técnico Customizing the Ribbon in Outlook 2007.
Utilizar XML de la cinta de opciones
Si utiliza el elemento Cinta (XML), compruebe el valor del parámetro ribbonID en el método Microsoft.Office.Core.IRibbonExtensibility.GetCustomUI y devuelva la cinta de opciones adecuada.
Visual Studio Tools para Office genera automáticamente el método Microsoft.Office.Core.IRibbonExtensibility.GetCustomUI en el archivo de código de la cinta de opciones. El parámetro ribbonID es una cadena que identifica un tipo específico de Inspector. Para obtener una lista completa de valores posibles del parámetro ribbonID, vea el artículo técnico Customizing the Ribbon in Outlook 2007.
El siguiente ejemplo de código demuestra cómo presentar una cinta de opciones personalizada sólo en el inspector de Microsoft.Outlook.Mail.Compose. Éste 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 método GetResourceText(), 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 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
public string GetCustomUI(string ribbonID)
{
string ribbonXML = String.Empty;
if (ribbonID == "Microsoft.Outlook.Mail.Compose")
{
ribbonXML = GetResourceText("Trin_RibbonOutlookBasic.Ribbon1.xml");
}
return ribbonXML;
}
Vea también
Conceptos
Acceso a la cinta de opciones en tiempo de ejecución
Información general sobre la cinta de opciones