Crear áreas de formulario de Outlook
Puede utilizar las áreas de formulario para personalizar los formularios de Microsoft Office Outlook. Visual Studio proporciona herramientas avanzadas que facilitan el diseño, el desarrollo y la depuración de las áreas de formulario.
Se aplica a: la información de este tema se aplica a los proyectos de nivel de aplicación para Outlook 2007 y Outlook 2010. Para obtener más información, vea Características disponibles por aplicación y tipo de proyecto de Office.
En este tema se proporciona la información siguiente:
Ventajas de utilizar áreas de formulario
Agregar un área de formulario de Outlook a un proyecto
Utilizar el Diseñador de áreas de formulario
Utilizar un área de formulario diseñada en Outlook
Agregar código personalizado a un área de formulario
Compilar el proyecto
Depurar un área de formulario
Implementar un área de formulario
Ventajas de utilizar áreas de formulario
Las áreas de formulario ofrecen muchas mejoras sobre el desarrollo tradicional de formularios de Outlook:
Personalizar la página predeterminada de cualquier formulario estándar.
Agregar hasta 12 páginas adicionales a cualquier formulario estándar.
Reemplazar o mejorar cualquier formulario estándar.
Mostrar la interfaz de usuario personalizada en el panel de lectura y en los inspectores.
Para obtener más información, vea Customizing Form Pages and Form Regions.
Agregar un área de formulario de Outlook a un proyecto
Puede utilizar el asistente Nueva área de formulario de Outlook para diseñar una nueva área de formulario o importar un área de este tipo diseñada en Outlook. Además, si tiene un área de formulario que ha utilizado en otro proyecto de complemento de Outlook, puede volver a utilizarla.
Crear una nueva área de formulario mediante el asistente
Para crear un área de formulario, agregue un elemento Área de formulario de Outlook a un proyecto de complemento de Outlook. De esta forma se inicia el asistente Nueva área de formulario de Outlook.
Utilice el asistente para indicar si desea diseñar una nueva área de formulario o bien importar una diseñada en Outlook. Para obtener más información sobre cómo diseñar una nueva área de formulario, vea Utilizar el Diseñador de áreas de formulario. Para obtener más información sobre cómo utilizar un área de formulario diseñada en Outlook, vea Importar un área de formulario diseñada en Outlook.
Utilice el asistente para especificar el tipo de área de formulario que desea crear. En la tabla siguiente se describen los tipos de área de formulario.
Tipo de área |
Descripción |
|---|---|
Independiente |
Agrega el área de formulario como una página nueva en un formulario de Outlook. |
Adyacente |
Anexa el área de formulario a la parte inferior de la página predeterminada de un formulario de Outlook. |
Reemplazo |
Agrega el área de formulario como una página nueva que reemplaza a la página predeterminada de un formulario de Outlook. |
Reemplazo total |
Reemplaza todo el formulario de Outlook por el área de formulario. |
También puede utilizar el asistente para especificar las condiciones de presentación y seleccionar el tipo de formulario que se va a ampliar. Para obtener más información, vea Cómo: Agregar un área de formulario a un proyecto de complemento de Outlook.
Las selecciones que realiza en el asistente afectan a las opciones que estarán disponibles en otras páginas del mismo. Por ejemplo, si selecciona Adyacente o Independiente en la página Crear nueva área de formulario de Outlook, los campos Título y Descripción no estarán disponibles en la página Proporcione texto descriptivo y seleccione sus preferencias de presentación. Esto se debe a que Outlook no utiliza estos campos cuando muestra un área de formulario adyacente o independiente.
Archivos de área de formulario
Cuando se completa el asistente Nueva área de formulario de Outlook, Visual Studio agrega automáticamente los siguientes archivos al proyecto:
Un archivo de código del área de formulario. Este archivo tiene el nombre especificado para el elemento Área de formulario de Outlook en el cuadro de diálogo Agregar nuevo elemento. Agregue código para controlar los eventos del área de formulario en este archivo.
Un archivo de código del Diseñador de áreas de formulario. Este archivo contiene código generado por el Diseñador de áreas de formulario y no debe editarse directamente.
Un archivo de almacén de formularios de Outlook (.ofs).
Nota
Este archivo sólo se agrega al proyecto si se importa un área de formulario diseñada en Outlook.
Clase de generador de áreas de formulario
El archivo de código del área de formulario contiene una clase parcial que implementa la interfaz IFormRegionFactory. Esta es la clase de generador de áreas de formulario. La clase de generador de áreas de formulario es responsable de crear nuevas instancias del área de formulario.
Para encontrar esta clase, expanda el área Generador de áreas de formulario.
El asistente Nueva área de formulario de Outlook agrega atributos a esta clase que especifican el nombre interno del área de formulario y las clases de mensaje que muestran dicha área. Puede modificar estos atributos manualmente una vez agregado el archivo al proyecto.
La mayor parte de la clase de generador de áreas de formulario se implementa en el archivo del Diseñador de áreas de formulario. Sin embargo, el controlador de eventos FormRegionInitializing se expone en el archivo de código del área de formulario. Puede utilizar este controlador de eventos para especificar si Outlook debe mostrar el área de formulario. Para obtener más información, vea Controlar eventos de áreas de formulario.
Agregar un área de formulario existente a un proyecto
Si ha utilizado un área de formulario de Outlook en otro proyecto de Outlook, puede volver a utilizarla en el actual proyecto de complemento de Outlook mediante el cuadro de diálogo Agregar elemento existente.
El área de formulario existente debe tener un archivo de código (.vb o .cs). El cuadro de diálogo Agregar elemento existente no permite agregar archivos de almacén de formularios de Outlook (.ofs). Sin embargo, puede crear una nueva área de formulario importando un archivo de almacén de formularios de Outlook. Para obtener más información, vea Cómo: Agregar un área de formulario a un proyecto de complemento de Outlook.
Utilizar el Diseñador de áreas de formulario
El Diseñador de áreas de formulario ayuda a establecer el diseño y la apariencia de un área de este tipo. Puede arrastrar controles administrados a la superficie del diseñador, hacer doble clic en dichos controles para abrir los controladores de eventos y establecer las propiedades en la ventana Propiedades.
Nota
Puede encontrar propiedades que afectan a la forma en que aparece el área de formulario en Outlook bajo el nodo Manifiesto en la ventana Propiedades.
El Diseñador de áreas de formulario sólo está disponible si selecciona Diseñar una nueva área de formulario en la página Seleccione cómo desea crear el área de formulario del asistente Nueva área de formulario de Outlook.
Existen tres formas de abrir el Diseñador de áreas de formulario:
En el Explorador de soluciones, haga doble clic en el archivo de código del área de formulario.
En el Explorador de soluciones, haga clic con el botón secundario en el archivo de código del área de formulario y, a continuación, haga clic en Ver diseñador.
En el Explorador de soluciones, seleccione el archivo de código del área de formulario y, a continuación, haga clic en Diseñador en el menú Ver.
El Diseñador de áreas de formulario sólo admite controles administrados. No puede agregar controles nativos de Outlook.
Importar un área de formulario diseñada en Outlook
Al diseñar en Outlook, puede agregar controles nativos de Outlook al área de formulario. Los controles nativos de Outlook permiten enlazar a datos de Outlook en tiempo de diseño. Sin embargo, después no se podrá utilizar el Diseñador de áreas de formulario para agregar controles administrados o cambiar el diseño del área de formulario.
Puede importar áreas de formulario en un proyecto de complemento de Outlook mediante el asistente Nueva área de formulario de Outlook. En la página Seleccione cómo desea crear el área de formulario, seleccione Importar archivo de almacén de formulario de Outlook (.ofs). A continuación, puede desplazarse a la ubicación de un archivo de archivo de almacén de formularios de Outlook (.ofs). (Outlook guarda las áreas de formulario como archivos .ofs.)
El asistente Nueva área de formulario de Outlook copia el archivo .ofs en el directorio del proyecto y agrega referencias a los controles en el archivo del Diseñador de áreas de formulario. A continuación, puede controlar los eventos de control en el archivo de código del área de formulario.
Para controlar eventos en un proyecto de Visual Basic, seleccione un evento en la lista de nombres de métodos en la parte superior del Editor de código. Para obtener más información, vea How to: Create Event Handlers in the Visual Basic Code Editor.
Para controlar eventos en un proyecto de C#, suscríbase a los eventos de control en el método FormRegionShowing. Para obtener más información, vea Cómo: Suscribir y cancelar la suscripción a eventos (Guía de programación de C#).
Puede cambiar las propiedades del área de formulario en el método InitializeManifest de la clase de generador de áreas de formulario.
Nota
Para importar un área de formulario, debe estar trabajando en un proyecto destinado a la misma versión de Outlook que la instalada en el equipo de desarrollo. Por ejemplo, si tiene instalado Outlook 2010, la importación de un área de formulario solo funcionará en un proyecto que se creó mediante la plantilla de proyecto Complemento de Outlook 2010.
Actualizar el diseño de un área de formulario importada
Puede agregar, quitar o cambiar los controles del área de formulario. Antes de hacerlo, haga una copia de seguridad del código que haya agregado al archivo de código del área de formulario. A continuación, abra el archivo .ofs en Outlook, modifique el área de formulario y después guarde los cambios. Utilice el asistente Nueva región de formulario de Outlook para importar el archivo .ofs modificado. A continuación, puede pegar el código en el nuevo archivo de código del área de formulario.
Agregar código personalizado a un área de formulario
El espacio de nombres Microsoft.Office.Tools.Outlook proporciona acceso a las clases que representan el área de formulario, al elemento de Outlook que muestra dicha área y a otros elementos útiles. El elemento Área de formulario de Outlook agrega automáticamente una referencia a este ensamblado en el proyecto e inserta la instrucción using o Imports adecuada en la parte superior del archivo de código del área de formulario.
Puede utilizar clases, métodos y propiedades en el espacio de nombres Microsoft.Office.Interop.Outlook para realizar la mayoría de las tareas de programación de Outlook. Para obtener más información sobre el modelo de objetos de Outlook, vea Información general sobre el modelo de objetos de Outlook. Para obtener ejemplos de las tareas en las que se suele usar el modelo de objetos de Outlook, vea Soluciones de Outlook.
Controlar eventos de áreas de formulario
El elemento Área de formulario de Outlook agrega automáticamente los tres controladores de eventos siguientes al archivo de código del área de formulario.
Evento |
Descripción |
|---|---|
FormRegionInitializing |
Se produce antes de inicializarse el área de formulario. Puede comprobar las condiciones de este controlador de eventos para determinar si Outlook debe mostrar el área de formulario. Para obtener más información, vea Cómo: Impedir que Outlook muestre un área de formulario. |
FormRegionShowing |
Se produce después de crear una instancia del área de formulario pero antes de que ésta aparezca. |
FormRegionClosed |
Se produce antes de cerrar el área de formulario. |
Compilar el proyecto
Cuando se compila un proyecto de complemento de Outlook que contiene un área de formulario, Visual Studio agrega la siguiente información al Registro:
Una clave para cada clase de mensaje asociada con una o varias áreas de formulario.
Una entrada para cada área de formulario y un valor asociado que representa el nombre del complemento de Outlook.
Outlook utiliza esta información para cargar las áreas de formulario.
Depurar un área de formulario
Puede depurar un complemento de Outlook que contiene un área de formulario tal y como lo haría con otros proyectos de Visual Studio. Cuando se inicia el depurador de Visual Studio, Visual Studio inicia automáticamente Outlook.
Para ver el área de formulario, debe abrir el elemento de Outlook adecuado. Por ejemplo, si un área de formulario adyacente se anexa a la parte inferior de un elemento de correo, abra un elemento de correo.
Implementar un área de formulario
Las áreas de formulario se implementan automáticamente con el complemento de Outlook asociado. Por consiguiente, no tiene que realizar ninguna tarea especial para implementar un área de formulario. Para obtener más información sobre cómo implementar complementos, vea Implementar soluciones de Office.
Temas relacionados
Título |
Descripción |
|---|---|
Proporciona información que puede ayudar a optimizar las áreas del formulario y a evitar posibles problemas. |
|
Cómo: Agregar un área de formulario a un proyecto de complemento de Outlook |
Muestra cómo crear un área del formulario para extender un formulario de Microsoft Office Outlook estándar o personalizado mediante el asistente Nueva área de formulario de Outlook. |
Asociar un área de formulario a una clase de mensaje de Outlook |
Explica cómo especificar los elementos de Microsoft Office Outlook que van a mostrar un área del formulario asociando ésta a la clase de mensaje de cada elemento. |
Muestra cómo diseñar un área del formulario personalizada que aparece como una nueva página en la ventana de inspector de un elemento de contacto. |
|
Tutorial: Importar un área de formulario diseñada en Outlook |
Muestra cómo diseñar un área del formulario en Microsoft Office Outlook y cómo importarla a continuación a un proyecto de complemento de Outlook mediante el asistente Nueva área de formulario de Outlook. |
Describe cómo escribir código para mostrar, ocultar o modificar los controles de un área del formulario y permitir a los usuarios ejecutar código de otras áreas en el proyecto utilizando la clase Globals. |
|
Muestra cómo evitar que Microsoft Office Outlook muestre un área del formulario para un elemento determinado. |
|
Cómo: Obtener acceso al elemento de Outlook que muestra el área de formulario |
Muestra cómo tener acceso al elemento de Outlook en el que aparece un área del formulario. |
Describe cómo permitir que los usuarios respondan a un elemento de Outlook. |
|
Muestra cómo agregar una acción personalizada mediante un elemento Área de formulario de Outlook. |