Condividi tramite

Associazione di un'area del modulo a una classe messaggio di Outlook

  • Articolo

È possibile specificare gli elementi Microsoft Office Outlook che visualizzano un'area di modulo associando l'area di modulo alla classe di messaggio di ogni elemento. Ad esempio, se si vuole aggiungere un'area di modulo alla fine di un elemento di posta, è possibile associare l'area di modulo alla classe di messaggio IPM.Note.

Per associare un'area di modulo a una classe di messaggio, specificare il nome della classe di messaggio nella procedura guidata Nuova area del modulo di Outlook o applicare un attributo alla classe factory dell'area di modulo.

Si applica a: le informazioni fornite in questo argomento sono valide per i progetti a livello di applicazione per Outlook 2007 e Outlook 2010. Per ulteriori informazioni, vedere Funzionalità disponibili in base ai tipi di progetto e applicazioni di Office.

Informazioni sulle classi di messaggio di Outlook

Una classe di messaggio di Outlook identifica un tipo di elemento di Outlook. Nella tabella seguente sono elencati questi otto tipi di elementi standard e i relativi nomi della classe di messaggio.

Tipo di elemento di Outlook

Nome della classe di messaggio

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

È anche possibile specificare i nomi delle classi di messaggio personalizzate. Le classi di messaggio personalizzate identificano i moduli personalizzati definiti in Outlook.

Nota

Per le aree di modulo sostituzione e sostituzione completa, è possibile specificare un nuovo nome di classe di messaggio personalizzata. Non è necessario utilizzare il nome della classe di messaggio di un modulo personalizzato esistente. Il nome della classe di messaggio personalizzata deve essere univoco. Per essere certi che il nome sia univoco, utilizzare una convenzione di denominazione simile alla seguente: <StandardMessageClassName>. <Company>. <MessageClassName> (ad esempio: IPM.Note.Contoso.MyMessageClass).

Associazione di un'area del modulo a una classe messaggio di Outlook

Ci sono due modi per associare un'area di modulo a una classe di messaggio:

  • Utilizzare la procedura guidata Nuova area del modulo di Outlook.

  • Applicare gli attributi di classe.

Utilizzo della procedura guidata Nuova area del modulo di Outlook

Nella pagina finale della procedura guidata Nuova area del modulo di Outlook , è possibile selezionare le classi di messaggio standard e digitare i nomi delle classi di messaggio personalizzate da associare all'area di modulo.

Le classi di messaggio standard non sono disponibili se l'area di modulo è progettata per sostituire l'intero modulo o la pagina predefinita di un modulo. I nomi delle classi di messaggio standard possono essere specificati solo per i moduli che aggiungono una pagina nuova a un modulo o che vengono aggiunti alla fine di un modulo. Per ulteriori informazioni, vedere Procedura: aggiungere un'area del modulo a un progetto di componente aggiuntivo per Outlook.

Per includere una o più classi di messaggio personalizzate, digitare i nomi nella casella Fornire le classi di messaggi per la visualizzazione dell'area del modulo.

I nomi digitati devono essere conformi alle linee guida seguenti:

  • Utilizzare il nome completo della classe di messaggio, ad esempio: "IPM.Note.Contoso".

  • Utilizzare un punto e virgola per separare più nomi di classe di messaggio.

  • Non includere classi di messaggio standard di Outlook, ad esempio "IPM.Note" o "IPM.Contact." Includere solo classi di messaggio personalizzate, ad esempio "IPM.Note.Contoso."

  • Non specificare la classe di messaggio di base da sola (ad esempio: "IPM").

  • Non superare 256 caratteri per ogni nome della classe di messaggio.

La procedura guidata Nuova area del modulo di Outlook convalida il formato dell'input quando si fa clic su Fine.

Nota

La procedura guidata Nuova area del modulo di Outlook non verifica che i nomi delle classi di messaggio forniti siano corretti o validi.

Al termine, la procedura guidata Nuova area del modulo di Outlook applica gli attributi alla classe dell'area di modulo che contiene i nomi delle classi di messaggio specificati. È possibile applicare questi attributi anche manualmente.

Applicazione degli attributi di classe

È possibile associare un'area di modulo a una classe di messaggio di Outlook dopo avere completato la procedura guidata Nuova area del modulo di Outlook . A tale scopo, applicare attributi alla classe factory dell'area di modulo.

Nell'esempio seguente sono illustrati due attributi FormRegionMessageClassAttribute applicati a una classe factory dell'area di modulo denominata myFormRegion. Il primo attributo associa l'area di modulo a una classe di messaggio standard per un modulo di messaggio di posta. Il secondo attributo associa l'area di modulo a una classe di messaggio personalizzata denominata 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)
    {
    }
}

Gli attributi devono essere conformi alle linee guida seguenti:

  • Per le classi di messaggio personalizzate, utilizzare il nome completo della classe di messaggio, ad esempio: "IPM.Note.Contoso".

  • Non specificare la classe di messaggio di base da sola (ad esempio: "IPM").

  • Non superare 256 caratteri per ogni nome della classe di messaggio.

  • Non includere i nomi delle classi di messaggio standard se l'area di modulo sostituisce l'intero modulo o la pagina predefinita di un modulo. I nomi delle classi di messaggio standard possono essere specificati solo per i moduli che aggiungono una pagina nuova a un modulo o che vengono aggiunti alla fine di un modulo. Per ulteriori informazioni, vedere Procedura: aggiungere un'area del modulo a un progetto di componente aggiuntivo per Outlook.

Visual Studio convalida il formato dei nomi delle classi di messaggio quando il progetto viene compilato.

Nota

Visual Studio non verifica che i nomi delle classi di messaggio forniti siano corretti o validi.

Vedere anche

Attività

Procedura dettagliata: progettazione di un'area del modulo di Outlook

Riferimenti

About the form name and message class (informazioni in lingua inglese)

How Outlook forms and items work together (informazioni in lingua inglese)

Concetti

Accesso a un'area del modulo in fase di esecuzione

Linee guida per la creazione delle aree di modulo di Outlook

Altre risorse

Creazione di aree di modulo di Outlook