Crear áreas de formulario de Outlook

Artículo
04/28/2010

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 Proyectos de nivel de aplicación Versión de Microsoft Office Outlook 2007 Para obtener más información, vea Características disponibles por aplicación y tipo de proyecto.

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

Proyectos de nivel de aplicación

Versión de Microsoft Office

Outlook 2007

Para obtener más información, vea Características disponibles por aplicación y tipo de proyecto.

Puede utilizar áreas de formulario para personalizar los formularios de Microsoft Office Outlook. Visual Studio Tools para Office proporciona herramientas avanzadas que facilitan el diseño, el desarrollo y la depuración de las áreas de formulario.

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
Generar 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 Visual Studio Tools para Office, 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

Al completar el asistente Nueva área de formulario de Outlook, Visual Studio Tools para Office agrega los archivos siguientes al proyecto de forma automática:

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.

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 Visual Studio Tools para Office, puede volver a utilizarla en el proyecto de complemento de Outlook actual 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 Cómo: Crear controladores de eventos en el Editor de código de Visual Basic.

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.

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 área 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 tareas habituales que utilizan el modelo de objetos de Outlook en Visual Studio Tools para Office, 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.

Generar el proyecto

Cuando se genera un proyecto de complemento de Outlook que contiene un área de formulario, Visual Studio Tools para Office agrega la información siguiente al Registro:

Una clave para cada clase de mensaje asociada a 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. Al iniciar el depurador de Visual Studio, Visual Studio Tools para Office inicia Outlook automáticamente.

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 (2007 System).