Compartir a través de

Asociar un área de formulario a una clase de mensaje de Outlook

  • Artículo

Puede especificar los elementos de Microsoft Office Outlook que van a mostrar un área de formulario asociando ésta a la clase de mensaje de cada elemento.Por ejemplo, si desea anexar un área de formulario a la parte inferior de un elemento de correo, puede asociarla a la clase de mensaje IPM.Note.

Para asociar un área de formulario a una clase de mensaje, especifique el nombre de la clase de mensaje en el asistente Nueva región de formulario de Outlook o aplique un atributo a la clase de generador de áreas de formulario.

Se aplica a: La información de este tema se aplica a los proyectos de nivel de aplicación para Outlook 2013 y Outlook 2010. Para obtener más información, vea Características disponibles por aplicación y tipo de proyecto de Office.

Descripción de las clases de mensaje de Outlook

Una clase de mensaje de Outlook identifica un tipo de elemento de Outlook.En la tabla siguiente se muestran los ocho tipos estándar de elementos y los nombres de las clases de mensaje.

Tipo de elemento de Outlook

Nombre de la clase de mensaje

AppointmentItem

IPM.Appointment

ContactItem

IPM.Contact

DistListItem

IPM.DistList

JournalItem

IPM.Activity

MailItem

IPM.Note

PostItem

IPM.Post o IPM.Post.RSS

TaskItem

IPM.Task

También puede especificar los nombres de clases de mensaje personalizadas.Las clases de mensaje personalizadas identifican los formularios personalizados que se definen en Outlook.

[!NOTA]

Para las áreas de formulario de reemplazo y de reemplazo total, puede especificar un nuevo nombre de clase de mensaje personalizado.No es necesario utilizar el nombre de clase de mensaje de un formulario personalizado existente.El nombre de la clase de mensaje personalizada debe ser único.Para asegurarse de que el nombre es único, utilice una convención de nomenclatura similar a la siguiente: <nombreDeClaseDeMensajeEstándar>.<Compañía>.<nombreDeClaseDeMensaje> (por ejemplo: IPM.Note.Contoso.MyMessageClass).

Asociar una región de formulario a una clase de mensaje de Outlook

Un área de formulario se puede asociar a una clase de mensaje de dos maneras:

  • Usando el asistente Nueva región de formulario de Outlook.

  • Aplicando atributos de clase.

Bb157886.collapse_all(es-es,VS.110).gifUtilizar el asistente Nueva región de formulario de Outlook

En la última página del asistente Nueva región de formulario de Outlook , puede seleccionar clases de mensaje estándar y escribir los nombres de las clases de mensaje personalizadas que desee asociar al área de formulario.

Las clases de mensaje estándar no están disponibles si el área de formulario está diseñada para reemplazar todo el formulario o la página predeterminada de un formulario.Puede especificar nombres de clase de mensaje estándar sólo para los formularios que agregan una nueva página a un formulario o que están anexados a la parte inferior de un formulario.Para obtener más información, vea Cómo: Agregar un área de formulario a un proyecto de complemento de Outlook.

Para incluir una o varias clases de mensaje personalizadas, escriba sus nombres en el cuadro ¿Qué clases de mensaje personalizadas mostrarán esta área de formulario?

Los nombres que escriba deberán cumplir las siguientes instrucciones:

  • Utilice el nombre de clase de mensaje completo (por ejemplo: "IPM.Note.Contoso").

  • Utilice los signos de punto y coma para separar varios nombres de clase de mensaje.

  • No incluya clases de mensaje estándar de Outlook, como "IPM.Note" o "IPM.Contact".Incluya sólo clases de mensaje personalizadas, como "IPM.Note.Contoso".

  • No especifique la clase de mensaje base propiamente dicha (por ejemplo: "IPM").

  • No utilice más de 256 caracteres para cada nombre de clase de mensaje.

El asistente Nueva región de formulario de Outlook validará el formato de los datos proporcionados cuando el usuario haga clic en Finalizar.

[!NOTA]

El asistente Nueva región de formulario de Outlook no comprueba si los nombres de clase de mensaje proporcionados son correctos o válidos.

Cuando complete el asistente Nueva región de formulario de Outlook, éste aplicará a la clase de área de formulario los atributos que contienen los nombres de clase de mensaje especificados.Estos atributos también se pueden aplicar manualmente.

Bb157886.collapse_all(es-es,VS.110).gifAplicar atributos de clase

Puede asociar un área de formulario a una clase de mensaje de Outlook después de completar el asistente Nueva región de formulario de Outlook .Para ello, aplique atributos a la clase de generador de áreas de formulario.

En el ejemplo siguiente se muestran dos atributos FormRegionMessageClassAttribute que se han aplicado a una clase de generador de áreas de formulario denominada myFormRegion.El primer atributo asocia el área de formulario a una clase de mensaje estándar para un formulario de mensaje de correo.El segundo atributo asocia el área de formulario a una clase de mensaje personalizada que se denomina IPM.Task.Contoso.

<Microsoft.Office.Tools.Outlook.FormRegionMessageClass(Microsoft.Office.Tools.Outlook.FormRegionMessageClassAttribute.Note)> _
<Microsoft.Office.Tools.Outlook.FormRegionMessageClass("IPM.Task.Contoso")> _
<Microsoft.Office.Tools.Outlook.FormRegionName("Trin_Outlook_FR_Attributes.FormRegion1")> _
Partial Public Class FormRegion1Factory

' Occurs before the form region is initialized.
' To prevent the form region from appearing, set e.Cancel to true.
' Use e.OutlookItem to get a reference to the current Outlook item.
    Private Sub FormRegion1Factory_FormRegionInitializing(ByVal sender As Object, ByVal e As Microsoft.Office.Tools.Outlook.FormRegionInitializingEventArgs) Handles Me.FormRegionInitializing

End Sub

[Microsoft.Office.Tools.Outlook.FormRegionMessageClass
    (Microsoft.Office.Tools.Outlook.FormRegionMessageClassAttribute.Note)]
[Microsoft.Office.Tools.Outlook.FormRegionMessageClass
    ("IPM.Task.Contoso")]
[Microsoft.Office.Tools.Outlook.FormRegionName
    ("Trin_Outlook_FR_Attributes.FormRegion1")]
public partial class FormRegion1Factory
{
    // Occurs before the form region is initialized.
    // To prevent the form region from appearing, set e.Cancel to true.
    // Use e.OutlookItem to get a reference to the current Outlook item.
    private void FormRegion1Factory_FormRegionInitializing(object sender, 
        Microsoft.Office.Tools.Outlook.FormRegionInitializingEventArgs e)
    {
    }
}

Los atributos deben cumplir las siguientes instrucciones:

  • Para las clases de mensaje personalizadas, utilice el nombre de clase de mensaje completo (por ejemplo: "IPM.Note.Contoso").

  • No especifique la clase de mensaje base propiamente dicha (por ejemplo: "IPM").

  • No utilice más de 256 caracteres para cada nombre de clase de mensaje.

  • No incluya los nombres de las clases de mensaje estándar si el área de formulario reemplaza todo el formulario o la página predeterminada de un formulario.Puede especificar nombres de clase de mensaje estándar sólo para los formularios que agregan una nueva página a un formulario o que están anexados a la parte inferior de un formulario.Para obtener más información, vea Cómo: Agregar un área de formulario a un proyecto de complemento de Outlook.

Visual Studio validará el formato de los nombres de las clases de mensaje cuando se compile el proyecto.

[!NOTA]

No comprueba si los nombres proporcionados son correctos o válidos.

Vea también

Tareas

Tutorial: Diseñar un área de formulario de Outlook

Referencia

Sobre el nombre del formulario y la clase de mensaje

Cómo Outlook forms y elementos colaboran

Conceptos

Obtener acceso a un área de formulario en tiempo de ejecución

Instrucciones para crear áreas de formulario de Outlook

Otros recursos

Crear áreas de formulario de Outlook