Crear áreas de formulario de OutlookCreate Outlook form regions

Puede usar las áreas de formulario para personalizar los formularios de Microsoft Office Outlook.You can use form regions to customize Microsoft Office Outlook forms. Visual Studio proporciona herramientas avanzadas que facilitan el diseño, el desarrollo y la depuración de las áreas de formulario.Visual Studio provides advanced tools that make it easier for you to design, develop, and debug form regions.

Se aplica a: la información de este tema se aplica a VSTO agregar-en los proyectos de 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 tipo de aplicación y el proyecto de Office.For more information, see Features available by Office application and project type.

En este tema se proporciona la información siguiente:This topic provides the following information:

Ventajas de usar áreas de formularioAdvantages of using form regions

Las áreas de formulario ofrecen muchas mejoras sobre el desarrollo tradicional de formularios de Outlook:Form regions offer many enhancements over traditional Outlook forms development:

  • Personalizar la página predeterminada de cualquier formulario estándar.Customize the default page of any standard form.

  • Agregar hasta 12 páginas adicionales a cualquier formulario estándar.Add up to 12 extra pages to any standard form.

  • Reemplazar o mejorar cualquier formulario estándar.Replace or enhance any standard form.

  • Mostrar la interfaz de usuario personalizada en el panel de lectura y en los inspectores.Display custom UI in the Reading Pane and in Inspectors.

    Para obtener más información, consulte personalizar las páginas de formulario y áreas de formulario.For more information, see Customize form pages and form regions.

Agregar un área de formulario de Outlook al proyectoAdd an Outlook form region to your project

Puede usar el nueva área de formulario de Outlook Asistente para diseñar una nueva área de formulario o importar un área de formulario diseñada en Outlook.You can use the New Outlook Form Region wizard to design a new form region or import a form region that was designed in Outlook. Además, si tiene un área de formulario que ha usado en otro proyecto de complemento de VSTO de Outlook, puede volver a usarla.Also, if you have a form region that you used in another Outlook VSTO Add-in project, you can reuse your existing form region.

Crear una nueva área de formulario mediante el Asistente paraCreate a new form region by using the wizard

Para crear un área de formulario, agregue un área de formulario de Outlook elemento a un proyecto de complemento de VSTO de Outlook.To create a form region, add an Outlook Form Region item to an Outlook VSTO Add-in project. Esto inicia el nueva área de formulario de Outlook asistente.This starts the New Outlook Form Region wizard.

Use el asistente para indicar si desea diseñar una nueva área de formulario o importar una diseñada en Outlook.Use the wizard to indicate whether you want to design a new form region or import a form region that was designed in Outlook. Para obtener más información acerca de cómo diseñar un nueva área de formulario, vea utilizar el Diseñador de áreas de formulario.For more information about designing a new form region, see Use the form region designer. Para obtener más información sobre el uso de un área de formulario diseñado en Outlook, consulte importar un área de formulario diseñado en Outlook.For more information about using a form region designed in Outlook, see Import a form region designed in Outlook.

Use el asistente para especificar el tipo de área de formulario que desea crear.Use the wizard to specify the type of form region you want to create. En la siguiente tabla se describen todos los tipos de área de formulario.The following table describes each form region type.

Tipo de áreaRegion type DescripciónDescription
IndependienteSeparate Agrega el área de formulario como una página nueva en un formulario de Outlook.Adds the form region as a new page in an Outlook form.
AdyacenteAdjoining Anexa el área de formulario a la parte inferior de la página predeterminada de un formulario de Outlook.Appends the form region to the bottom of an Outlook form's default page.
ReplacementReplacement Agrega el área de formulario como una página nueva que reemplaza la página predeterminada de un formulario de Outlook.Adds the form region as a new page that replaces the default page of an Outlook form.
Reemplazar todoReplace-all Reemplaza todo el formulario de Outlook por el área de formulario.Replaces the whole Outlook form with the form region.

También puede usar el asistente para especificar las condiciones de presentación y seleccionar el tipo de formulario que se va a extender.You can also use the wizard to specify display conditions and to select the type of form to extend. Para obtener más información, consulte Cómo: agregar un área de formulario a un proyecto de complemento de Outlook.For more information, see How to: Add a form region to an Outlook Add-in project.

Las selecciones que haga en el asistente afectarán a las opciones que estén disponibles en otras páginas del asistente.The selections that you make in the wizard affect the options that are available in other wizard pages. Por ejemplo, si selecciona adyacente o independiente en el crear una nueva área de formulario de Outlook página, la título y Descripción campos no están disponibles en la proporcione texto descriptivo y seleccione sus preferencias de presentación página.For example, if you select Adjoining or Separate in the Create a New Outlook Form Region page, then the Title and Description fields are unavailable in the Supply descriptive text and select your display preferences page. Esto se debe a que Outlook no usa estos campos cuando muestra un área de formulario adyacente o independiente.This is because Outlook does not use these fields when it displays an adjoining or separate form region.

Archivos de áreas de formularioForm region files

Cuando complete la nueva área de formulario de Outlook asistente, Visual Studio agrega automáticamente los siguientes archivos al proyecto:When you complete the New Outlook Form Region wizard, Visual Studio automatically adds the following files to your project:

  • Un archivo de código del área de formulario.A form region code file. Este archivo tiene el nombre que especifique para la área de formulario de Outlook de elemento en el Agregar nuevo elemento cuadro de diálogo.This file has the name that you specify for the Outlook Form Region item in the Add New Item dialog box. Agregue código para controlar los eventos del área de formulario en este archivo.Add code to handle form region events to this file.

  • Un archivo de código del Diseñador de áreas de formulario.A form region designer code file. Este archivo contiene código generado por el Diseñador de áreas de formulario y no debe editarse directamente.This file contains code generated by the form region designer and should not be directly edited.

  • Un almacén de formularios de Outlook (.ofs) archivos.An Outlook Form Storage (.ofs) file.

    Note

    Este archivo solo se agrega al proyecto si se importa un área de formulario diseñada en Outlook.This file is only added to the project if you import a form region that was designed in Outlook.

Clase de generador de áreas de formularioForm region factory class

El archivo de código del área de formulario contiene una clase parcial que implementa la interfaz IFormRegionFactory.The form region code file contains a partial class that implements the IFormRegionFactory interface. Se trata de la clase de generador de áreas de formulario.This is the form region factory class. La clase de generador de áreas de formulario es responsable de crear nuevas instancias del área de formulario.The form region factory class is responsible for creating new instances of the form region.

Puede encontrar esta clase, expanda la generador de áreas de formulario región.You can find this class by expanding the Form Region Factory region.

El nueva área de formulario de Outlook asistente agrega los atributos para esta clase que especifican el nombre interno del área del formulario y las clases de mensaje que muestran el área de formulario.The New Outlook Form Region wizard adds attributes to this class that specify the internal name of the form region and the message classes that display the form region. Puede modificar estos atributos manualmente una vez agregado el archivo al proyecto.You can modify these attributes manually after the file has been added to the project.

La mayor parte de la clase de generador de áreas de formulario se implementa en el archivo del Diseñador de áreas de formulario.Most of the form region factory class is implemented in the form region designer file. Sin embargo, el controlador de eventos FormRegionInitializing se expone en el archivo de código del área de formulario.However, the FormRegionInitializing event handler is exposed in the form region code file. Puede usar este controlador de eventos para especificar si Outlook debe mostrar el área de formulario.You can use this event handler to specify whether Outlook should display the form region. Para obtener más información, consulte controlar los eventos de la región de formulario.For more information, see Handle form region events.

Agregar un área de formulario existente al proyectoAdd an existing form region to your project

Si ha usado un área de formulario de Outlook en otro proyecto de Outlook, puede volver a usarla en el proyecto de complemento de VSTO de Outlook actual mediante el cuadro de diálogo Agregar elemento existente .If you have an Outlook form region that you used in another Outlook project, you can reuse it in your current Outlook VSTO Add-in project by using the Add Existing Item dialog box.

El área de formulario existente debe tener un archivo de código (.vb o .cs); no se puede agregar almacenamiento de formularios de Outlook (.ofs) archivos mediante el uso de la Agregar elemento existente cuadro de diálogo.The existing form region must have a code file (.vb or .cs); you cannot add Outlook Form Storage (.ofs) files by using the Add Existing Item dialog box. Sin embargo, puede crear una nueva área de formulario importando un archivo de almacén de formularios de Outlook.However, you can create a new form region by importing an Outlook Form Storage file. Para obtener más información, consulte Cómo: agregar un área de formulario a un proyecto de complemento de Outlook.For more information, see How to: Add a form region to an Outlook Add-in project.

Use el Diseñador de áreas de formularioUse the form region designer

El Diseñador de áreas de formulario ayuda a establecer el diseño y la apariencia de un área de este tipo.The form region designer helps you to design the layout and appearance of a form region. Puede arrastrar controles administrados a la superficie del diseñador, haga doble clic en controles para abrir los controladores de eventos y establecer propiedades en el propiedades ventana.You can drag managed controls to the surface of the designer, double-click controls to open event handlers, and set properties in the Properties window.

Note

Puede buscar propiedades que afectan al modo en que aparece el área de formulario en Outlook bajo el manifiesto nodo en el propiedades ventana.You can find properties that affect the way the form region appears in Outlook beneath the Manifest node in the Properties window.

El Diseñador de áreas de formulario solo está disponible si selecciona diseñar una nueva área de formulario en el Seleccione cómo desea crear el área de formulario página de la nueva área de formulario de Outlook Asistente.The form region designer is available only if you select Design a New Form Region in the Select how you want to create the form region page of the New Outlook Form Region wizard.

Existen tres maneras de abrir el Diseñador de áreas de formulario:There are three ways to open the form region designer:

  • En el Explorador de soluciones, haga doble clic en el archivo de código de área de formulario.In Solution Explorer, double-click the form region code file.

  • En el Explorador de soluciones, haga clic en el archivo de código de área de formulario y, a continuación, haga clic en Diseñador de vistas.In Solution Explorer, right-click the form region code file, and then click View Designer.

  • En el Explorador de soluciones, seleccione el archivo de código de área de formulario y, a continuación, en la vista menú, haga clic en diseñador.In Solution Explorer, select the form region code file, and then, on the View menu, click Designer.

    El Diseñador de áreas de formulario solo admite controles administrados.The form region designer supports only managed controls. No puede agregar controles nativos de Outlook.You cannot add native Outlook controls.

Importar un área de formulario diseñado en OutlookImport a form region designed in Outlook

Al diseñar en Outlook, puede agregar controles nativos de Outlook al área de formulario.When you design in Outlook, you can add native Outlook controls to the form region. Los controles nativos de Outlook permiten enlazar a datos de Outlook en tiempo de diseño.Native Outlook controls enable you to bind to Outlook data at design time. Sin embargo, después no se podrá usar el Diseñador de áreas de formulario para agregar controles administrados o cambiar el diseño del área de formulario.However, you cannot then use the form region designer to add managed controls or change the design of the form region.

Puede importar áreas de formulario en un proyecto de complemento de VSTO para Outlook mediante el nueva área de formulario de Outlook asistente.You can import form regions into an Outlook VSTO Add-in project by using the New Outlook Form Region wizard. En el Seleccione cómo desea crear el área de formulario , seleccione importar un archivo de almacén de formularios de Outlook (.ofs).On the Select how you want to create the form region page, select Import an Outlook Form Storage (.ofs) file. A continuación, puede examinar a la ubicación de un archivo de almacén de formularios de Outlook (.ofs) archivos.You can then browse to the location of an Outlook Form Storage file (.ofs) file. (Outlook guarda las áreas de formulario como .ofs archivos.)(Outlook saves form regions as .ofs files.)

El nueva área de formulario de Outlook copias del Asistente para la .ofs de archivos al directorio del proyecto y agrega referencias de control para el archivo de diseñador de área de formulario.The New Outlook Form Region wizard copies the .ofs file to the project directory and adds control references to the form region designer file. Luego, puede controlar los eventos de control en el archivo de código del área de formulario.You can then handle control events in the form region code file.

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.To handle events in a Visual Basic project, select an event from the method name list at the top of the Code Editor.

Para controlar eventos en un proyecto de C#, suscríbase a los eventos de control en el método FormRegionShowing.To handle events in a C# project, subscribe to control events in the FormRegionShowing method. Para obtener más información, consulte Cómo: Suscribir y cancelar la suscripción a eventos (C# Guía de programación).For more information, see How to: Subscribe to and unsubscribe from events (C# programming guide).

Puede cambiar las propiedades del área de formulario en el método InitializeManifest de la clase de generador de áreas de formulario.You can change form region properties in the InitializeManifest method of the form region factory class.

Note

Para importar un área de formulario, debe estar trabajando en un proyecto destinado a la misma versión de Outlook que la que está instalada en el equipo de desarrollo.To import a form region, you must be working in a project that targets the same version of Outlook that you have installed on the development computer. Por ejemplo, si tiene instalado Outlook 2010, la importación de un formulario región solo funcionará en un proyecto se creó mediante la complemento de Outlook 2010 plantilla de proyecto.For example, if you have Outlook 2010 installed, importing a form region will only work in a project was created by using the Outlook 2010 Add-in project template.

Actualizar el diseño de un área de formulario importadaUpdate an imported form region's design

Puede agregar, quitar o cambiar los controles del área de formulario.You can add, remove, or change controls on the form region. Antes de hacerlo, haga una copia de seguridad del código que haya agregado al archivo de código del área de formulario.Before you do this, back up any code that you added to the form region code file. A continuación, abra el .ofs un archivo en Outlook, modificar el área de formulario y, a continuación, guarde los cambios.Then, open the .ofs file in Outlook, modify the form region, and then save the changes. Use la nueva área de formulario de Outlook Asistente para importar modificados .ofs archivo.Use the New Outlook Form Region wizard to import the modified .ofs file. Luego, puede pegar el código en el nuevo archivo de código del área de formulario.You can then paste your code into the new form region code file.

Agregar código personalizado a un área de formularioAdd custom code to a form region

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.The Microsoft.Office.Tools.Outlook namespace gives you access to classes that represent the form region, the Outlook item that displays the form region, and other useful items. El área de formulario de Outlook elemento agrega automáticamente una referencia a este ensamblado en el proyecto e inserta la correspondiente con o importaciones instrucción en la parte superior de la archivo de código de área de formulario.The Outlook Form Region item automatically adds a reference to this assembly in the project and inserts the appropriate using or Imports statement at the top of the form region code file.

Puede usar clases, métodos y propiedades en el espacio de nombres Microsoft.Office.Interop.Outlook para llevar a cabo la mayoría de las tareas de programación de Outlook.You can use classes, methods, and properties in the Microsoft.Office.Interop.Outlook namespace to accomplish most of your Outlook programming tasks. Para obtener más información sobre el modelo de objetos de Outlook, consulte información general sobre el modelo de objetos de Outlook.For more information about the Outlook object model, see Outlook object model overview. Para obtener ejemplos de las tareas habituales que utilizar el modelo de objetos de Outlook, consulte soluciones de Outlook.For examples of typical tasks that make use of the Outlook object model, see Outlook solutions.

Controlar eventos de áreas de formularioHandle form region events

El área de formulario de Outlook elemento agrega automáticamente los siguientes tres controladores de eventos para el archivo de código de área de formulario.The Outlook Form Region item automatically adds the following three event handlers to the form region code file.

eventoEvent DescripciónDescription
FormRegionInitializingFormRegionInitializing Se produce antes de inicializarse el área de formulario.Occurs before the form region is initialized. Puede comprobar las condiciones de este controlador de eventos para determinar si Outlook debe mostrar el área de formulario.You can check conditions in this event handler to determine whether Outlook should display the form region. Para obtener más información, consulte Cómo: impedir que Outlook muestre un área de formulario.For more information, see How to: Prevent Outlook from displaying a form region.
FormRegionShowingFormRegionShowing Se produce después de crear una instancia del área de formulario pero antes de que esta aparezca.Occurs after an instance of the form region is created but before the form region appears.
FormRegionClosedFormRegionClosed Se produce antes de cerrar el área de formulario.Occurs before the form region is closed.

Compilar el proyectoBuild the project

Cuando se compila un proyecto de complemento de VSTO de Outlook que contiene un área de formulario, Visual Studio agrega la siguiente información al registro:When you build an Outlook VSTO Add-in project that contains a form region, Visual Studio adds the following information to the registry:

  • Una clave para cada clase de mensaje asociada a una o varias áreas de formulario.A key for each message class that is associated with one or more form regions.

  • Una entrada para cada área de formulario y un valor asociado que representa el nombre del complemento de VSTO de Outlook.An entry for each form region and an associated value that represents the name of the Outlook VSTO Add-in.

    Outlook usa esta información para cargar las áreas de formulario.Outlook uses this information to load the form regions.

Depurar un área de formularioDebug a form region

Puede depurar un complemento de VSTO de Outlook que contiene un área de formulario tal y como lo haría con otros proyectos de Visual StudioVisual Studio.You can debug an Outlook VSTO Add-in that contains a form region just as you would debug other Visual StudioVisual Studio projects. Al iniciar el depurador de Visual StudioVisual Studio, Visual Studio inicia automáticamente Outlook.When you start the Visual StudioVisual Studio debugger, Visual Studio automatically starts Outlook.

Para ver el área de formulario, debe abrir el elemento de Outlook adecuado.To view the form region, you must open the appropriate Outlook item. Por ejemplo, si un área de formulario adyacente se anexa a la parte inferior de un elemento de correo, abra un elemento de correo.For example, if an adjoining form region is appended to the bottom of a mail item, open a mail item.

Implementar un área de formularioDeploy a form region

Las áreas de formulario se implementan automáticamente con el complemento de VSTO de Outlook asociado.Form regions are deployed automatically with the associated Outlook VSTO Add-in. Por lo tanto, no es necesario efectuar ninguna tarea especial para implementar un área de formulario.Therefore, you do not have to perform any special tasks to deploy a form region. Para obtener más información acerca de la implementación de complementos VSTO, consulte implementar una solución de Office.For more information about deploying VSTO Add-ins, see Deploy an Office solution.

TítuloTitle DescripciónDescription
Directrices para crean áreas de formulario de OutlookGuidelines for create Outlook form regions Proporciona información que le puede ayudar a optimizar las áreas del formulario y evitar posibles problemas.Provides information that can help you optimize your form regions and avoid potential problems.
Cómo: agregar un área de formulario a un proyecto de complemento de OutlookHow to: Add a form region to an Outlook Add-in project Muestra cómo crear un área de formulario para extender un formulario de Microsoft Office Outlook estándar o personalizado mediante el uso de la nueva área de formulario de Outlook asistente.Shows you how to create a form region to extend a standard or custom Microsoft Office Outlook form by using the New Outlook Form Region wizard.
Asociar un área de formulario a una clase de mensaje de OutlookAssociate a form region with an Outlook message class Explica cómo especificar los elementos de Microsoft Office Outlook que van a mostrar un área de formulario asociándola a la clase de mensaje de cada elemento.Explains how to specify which Microsoft Office Outlook items display a form region by associating the form region with the message class of each item.
Tutorial: Diseñar un área de formulario de OutlookWalkthrough: Design an Outlook form region Muestra cómo diseñar un área de formulario personalizada que aparece como una nueva página en la ventana del inspector de un elemento de contacto.Shows how to design a custom form region that appears as a new page in the Inspector window of a contact item.
Tutorial: Importar un área de formulario diseñada en OutlookWalkthrough: Import a form region that is designed in Outlook Muestra cómo diseñar un área de formulario en Microsoft Office Outlook y, a continuación, importar el área de formulario en un proyecto de complemento de VSTO para Outlook mediante el nueva área de formulario de Outlook asistente.Shows how to design a form region in Microsoft Office Outlook, and then import the form region into an Outlook VSTO Add-in project by using the New Outlook Form Region wizard.
Obtener acceso a un área de formulario en tiempo de ejecuciónAccess a form region at runtime Describe cómo escribir código para mostrar, ocultar o modificar los controles de un área de formulario y permitir a los usuarios ejecutar código de otras áreas del proyecto usando la clase Globals.Describes how to write code to show, hide, or modify controls on a form region, and enable users to run the code from other areas in your project by using the Globals class.
Cómo: impedir que Outlook muestre un área de formularioHow to: Prevent Outlook from displaying a form region Muestra cómo evitar que Microsoft Office Outlook muestre un área de formulario de un elemento determinado.Shows how to prevent Microsoft Office Outlook from displaying a form region for a particular item.
Muestra cómo tener acceso al elemento de Outlook en el que aparece un área de formulario.Shows how to access the Outlook item in which a form region appears.
Acciones personalizadas en áreas de formulario de OutlookCustom actions in Outlook form regions Describe cómo permitir que los usuarios respondan a un elemento de Outlook.Describes how to enable users to respond to an Outlook item.