Directrices para crear áreas de formulario de OutlookGuidelines to create Outlook form regions

La siguiente información puede ayudarle a optimizar las áreas del formulario y a evitar posibles problemas:The following information can help you optimize your form regions and avoid potential problems:

Usar nombres de región de formularioUse form region names

Existen varios nombres que se usan para describir el área de formulario.There are several names used to describe the form region. Es importante que comprenda la diferencia entre estos nombres y cómo afectan al área de formulario.It is important to understand the difference between these names and how they affect the form region. En la siguiente tabla se describe cada uno de los nombres.The following table describes each name.

Nombre del área de formularioForm region name DescripciónDescription
Nombre de elemento del área de formularioForm region item name Es el nombre que especifica para el elemento Área de formulario de Outlook en el cuadro de diálogo Agregar nuevo elemento .The name that you specify for the Outlook Form Region item in the Add New Item dialog box. Éste es el nombre del archivo de código del área de formulario que aparece en el Explorador de soluciones.This is the name of the form region code file that appears in Solution Explorer.
PropiedadFormRegionName FormRegionName property Debe especificar este nombre en la página Escriba un texto descriptivo y seleccione sus preferencias de presentación del asistente Nueva área de formulario de Outlook .You specify this name in the Supply descriptive text and select your display preferences page of the New Outlook Form Region wizard. Este nombre aparece como la propiedad FormRegionName en la ventana Propiedades .This name appears as the FormRegionName property in the Properties window.

Use la propiedad FormRegionName para especificar la etiqueta que identifica el área de formulario en la interfaz de usuario (UI) de Outlook.Use the FormRegionName property to specify the label that identifies the form region in the Outlook user interface (UI). En áreas de formulario independientes, este nombre aparece como un botón en la cinta de opciones del elemento de Outlook.For separate form regions, this name appears as a button on the Ribbon of the Outlook item.

En las áreas de formulario adyacentes, este nombre aparece como texto de encabezado sobre el área de formulario.For adjoining form regions, this name appears as header text above the form region.
Microsoft.Office.Tools.Outlook.FormRegionName AtributoMicrosoft.Office.Tools.Outlook.FormRegionName attribute Al agregar un elemento Área de formulario de Outlook al proyecto, Visual Studio establece esta propiedad en el nombre completo del área de formulario.When you add an Outlook Form Region item to the project, Visual Studio sets this property to the fully qualified name of the form region. El nombre completo predeterminado es el nombre del complemento VSTO conectado al nombre del área de formulario mediante un punto; por ejemplo, OutlookAddIn1.FormRegion1.The default fully qualified name is the name of the VSTO Add-in connected to the name of the form region by a dot—for example, OutlookAddIn1.FormRegion1.

Este nombre completo también aparece como atributo en la parte superior de la clase del generador del área del formulario.This fully qualified name also appears as an attribute at the top of the form region factory class.

Use el atributo Microsoft.Office.Tools.Outlook.FormRegionName para identificar de forma exclusiva el área de formulario en todos los complementos VSTO de Outlook. No puede cambiar el valor del atributo Microsoft.Office.Tools.Outlook.FormRegionName cambiando el nombre del elemento del área de formulario, ni cambiando la propiedad FormRegionName.Use the Microsoft.Office.Tools.Outlook.FormRegionName attribute to uniquely identify the form region across all Outlook VSTO Add-ins. You cannot change the value of the Microsoft.Office.Tools.Outlook.FormRegionName attribute by renaming the form region item or by changing the FormRegionName property. Para cambiar este nombre, debe modificar el atributo Microsoft.Office.Tools.Outlook.FormRegionName en el archivo de código del área de formulario.To change this name, you must modify the Microsoft.Office.Tools.Outlook.FormRegionName attribute in the form region code file.

Deshabilitar la herencia del área de formularioDisable form region inheritance

De forma predeterminada, una clase de mensaje personalizada hereda todas las asociaciones de área de formulario de la clase de mensaje base.By default, a custom message class inherits all the form region associations of the base message class. Por ejemplo, una clase de mensaje denominada IPM.Task.Contoso se deriva de IPM.Task.For example, a message class named IPM.Task.Contoso derives from IPM.Task. Por consiguiente, IPM.Task.Contoso hereda las asociaciones del área de formulario de IPM.Task.Therefore, IPM.Task.Contoso inherits the form region associations of IPM.Task.

Si no desea que el área de formulario esté asociada a una clase de mensaje derivada, establezca la propiedad ExactMessageClass del área de formulario en true.If you do not want the form region to be associated with any derived message classes, set the ExactMessageClass property of the form region to true. Por ejemplo, si asocia un área de formulario adyacente con IPM.Task y establezca el ExactMessageClass propiedad true, el área de formulario sólo se anexará a la parte inferior de un formulario de tareas estándar.For example, if you associate an adjoining form region with IPM.Task and set the ExactMessageClass property to true, the form region will only be appended to the bottom of a standard task form. El área de formulario no se anexará a la parte inferior de ninguna versión personalizada de un formulario de tareas estándar.The form region will not be appended to the bottom of any customized versions of a standard task form.

Comprender los tipos y nombres de clase de mensajeUnderstand types and message class names

El nombre de tipo de un elemento de Outlook difiere del nombre de la clase de mensaje de un elemento de Outlook.The type name of an Outlook item differs from the message class name of an Outlook item. Por ejemplo, el nombre de tipo de un elemento RSS es Microsoft.Office.Interop.Outlook.PostItem.For example, the type name of an RSS item is Microsoft.Office.Interop.Outlook.PostItem. El nombre de clase de mensaje de un elemento RSS es IPM.Post.RSS.The message class name of an RSS item is IPM.Post.RSS.

Use el nombre del tipo para hacer referencia a un elemento de Outlook en el código.Use the type name to reference an Outlook item in code. Para obtener una lista de nombres de tipo, consulte asociar un área de formulario a una clase de mensaje de Outlook.For a list of type names, see Associate a form region with an Outlook message class.

Use el nombre de la clase de mensaje de elementos de Outlook en el asistente Nueva área de formulario de Outlook para asociar el elemento al área de formulario.Use the message class name of Outlook items in the New Outlook Form Region wizard to associate the item with the form region. Para obtener una lista de nombres de clase de mensaje válidos, vea asociar un área de formulario a una clase de mensaje de Outlook.For a list of valid message class names, see Associate a form region with an Outlook message class.

Diseñar áreas de formulario adyacentes para el panel de lecturaDesign adjoining form regions for the Reading Pane

Puede usar el panel de lectura de Outlook para ofrecer una vista previa de un elemento de Outlook sin tener que abrir el elemento.You can use the Outlook Reading Pane to preview an Outlook item without opening the item. El panel de lectura está diseñado solo para su lectura.The Reading Pane is designed for reading only. Por consiguiente, es posible que los controles de entrada que se agregan a un área de formulario adyacente (como un cuadro de texto), no se comporten de la manera esperada cuando el elemento y el área de formulario se abren en el panel de lectura.Therefore, input controls that you add to an adjoining form region, such as a text box, might not behave as expected when the item and form region are open in the Reading Pane.

Por ejemplo, si un elemento que tiene un área de formulario adyacente se abre en el panel de lectura, se puede producir la situación siguiente:For example, if an item that has an adjoining form region is open in the Reading Pane, the following situation is possible:

  1. Seleccione texto en el cuadro de texto que está incluido en el área de formulario.Select some text in a textbox that is on the form region.

  2. Presione eliminar.Press Delete.

  3. Se eliminará el elemento de correo al completo, en lugar del texto incluido en el cuadro de texto.The entire mail item is deleted instead of the text in the textbox.

    Si diseña un área de formulario adyacente que contenga controles de entrada, pruebe los controles en el panel de lectura para asegurarse de que funcionan correctamente.If you are designing an adjoining form region that contains input controls, test the controls in the Reading Pane to ensure they work properly. Considere la posibilidad de agregar código personalizado que deshabilite los controles que no funcionen según lo esperado.Consider adding custom code that disables controls that do not behave as expected.

    Asimismo, también puede establecer la propiedad ShowInspectorRead del área de formulario en False.Alternatively, you can set the ShowInspectorRead property of the form region to False. De esta manera, el área de formulario no se podrá usar en el panel de lectura.This way the form region cannot be used in the Reading Pane.

Usar tamaños de icono óptimosUse optimal icon sizes

Puede especificar qué iconos desea mostrar en el área de formulario, estableciendo las propiedades de iconos en el grupo de propiedades Iconos de la ventana Propiedades .You can specify which icons you want the form region to display by setting icon properties in the Icons property group of the Properties window. Use las siguientes instrucciones para lograr una calidad visual inmejorable:Use the following guidelines to achieve the best visual quality:

  • Para el icono Página , use un archivo de formato PNG (Portable Network Graphics).For the Page icon, use a Portable Network Graphics (PNG) file.

  • Los iconosVentana deben tener 32 por 32 píxeles.Window icons should be 32 pixels by 32 pixels.

  • Todos los demás iconos deben ser de 16 por 16 píxeles.All other icons should be 16 pixels by 16 pixels.

    El icono Página aparecerá en la cinta de opciones de un inspector, en aquellos elementos que tengan áreas de formulario de tipo Independiente, Reemplazo o Reemplazo total.The Page icon appears on the Ribbon of an Inspector for items that have separate, replacement, or replace-all form regions.

    El ventana icono aparece en el área de notificación y en el Alt+ficha elementos de cuadro de diálogo para abrir esa presentación reemplazo o formulario de reemplazo regiones.The Window icon appears in the notification area and in the Alt+Tab dialog box for open items that display replacement or replace-all form regions.

Vea tambiénSee also