Partager via


Association d'une zone de formulaire à une classe de message Outlook

Vous pouvez spécifier quels éléments de Microsoft Office Outlook affichent une zone de formulaire en associant la zone à la classe de message de chaque élément.Par exemple, si vous souhaitez ajouter une zone de formulaire au bas d'un élément de messagerie, vous pouvez associer la zone à la classe de message IPM.Note.

Pour associer une zone de formulaire à une classe de message, spécifiez le nom de classe dans l'Assistant Nouvelle zone de formulaire Outlook ou appliquez un attribut à la classe de fabrique de zones de formulaire.

S'applique à : Les informations contenues dans cette rubrique s'appliquent aux projets de niveau application pour Outlook 2013 et Outlook 2010. Pour en savoir plus, consultez Fonctionnalités disponibles par type d'application et de projet Office.

Fonctionnement des classes de message Outlook

Une classe de message Outlook identifie un type d'élément Outlook.Le tableau suivant répertorie les huit types d'éléments standard et les noms de classe de message correspondants.

Type d'élément Outlook

Nom de classe de message

AppointmentItem

IPM.Appointment

ContactItem

IPM.Contact

DistListItem

IPM.DistList

JournalItem

IPM.Activity

MailItem

IPM.Note

PostItem

IPM.Post ou IPM.Post.RSS

TaskItem

IPM.Task

Vous pouvez également spécifier les noms de classes de message personnalisées.Les classes de message personnalisées identifient des formulaires personnalisés que vous définissez dans Outlook.

[!REMARQUE]

Pour les zones de formulaire de remplacement et de remplacement global, vous pouvez spécifier un nouveau nom de classe de message personnalisée.Il n'est pas nécessaire d'utiliser le nom de classe de message d'un formulaire personnalisé existant.Le nom de la classe de message personnalisée doit être unique.Pour vous assurer que le nom est unique, vous pouvez utiliser une convention d'affectation de noms respectant le schéma suivant : <NomClasseMessageStandard>.<Société>.<NomClasseMessage> (par exemple: IPM.Note.Contoso.MyMessageClass).

Association d'une zone de formulaire à une classe de message Outlook

Il existe deux moyens d'associer une zone de formulaire à une classe de message :

  • À l'aide de l'Assistant Nouvelle zone de formulaire Outlook.

  • En appliquant des attributs de classe.

Bb157886.collapse_all(fr-fr,VS.110).gifUtilisation de l'Assistant Nouvelle zone de formulaire Outlook

Sur la dernière page de l'Assistant Nouvelle zone de formulaire Outlook, vous pouvez sélectionner des classes de message standard et saisir les noms de classes de message personnalisées à associer à la zone de formulaire.

Les classes de message standard ne sont pas disponibles si la zone de formulaire est destinée à remplacer l'ensemble du formulaire ou la page par défaut d'un formulaire.Vous pouvez spécifier des noms de classe de message standard uniquement pour les formulaires qui ajoutent une nouvelle page à un formulaire ou qui sont ajoutés à la fin d'un formulaire.Pour plus d’informations, consultez Comment : ajouter une zone de formulaire à un projet de complément Outlook.

Pour inclure une ou plusieurs classes de message personnalisées, saisissez leur nom dans la zone Quelles classes de message personnalisées afficheront cette zone de formulaire ?

Les noms saisis doivent respecter les recommandations suivantes :

  • Utilisez le nom de classe de message qualifié complet (par exemple, « IPM.Note.Contoso »).

  • Séparez les noms de classe de message par des points-virgules.

  • N'incluez pas de classes de message Outlook standard, telles que « IPM.Note » ou « IPM.Contact ».Vous pouvez uniquement inclure des classes de message personnalisées telles que « IPM.Note.Contoso ».

  • Ne spécifiez pas la classe de message de base seule (par exemple : « IPM »).

  • Les noms de classe de message ne doivent pas dépasser 256 caractères.

L'Assistant Nouvelle zone de formulaire Outlook valide le format de votre saisie lorsque vous cliquez sur Terminer.

[!REMARQUE]

L'Assistant Nouvelle zone de formulaire Outlook ne vérifie pas que les noms de classe de message fournis sont corrects ou valides.

Lorsque vous avez terminé, l'Assistant Nouvelle zone de formulaire Outlook applique à la classe de zone du formulaire des attributs qui contiennent les noms de classe de message spécifiés.Vous pouvez également appliquer ces attributs manuellement.

Bb157886.collapse_all(fr-fr,VS.110).gifApplication d'attributs de classe

Vous pouvez associer une zone de formulaire à une classe de message Outlook après avoir exécuté l'Assistant Nouvelle zone de formulaire Outlook.Pour cela, appliquez des attributs à la classe de fabrique de zones de formulaire.

L'exemple suivant affiche deux attributs FormRegionMessageClassAttribute appliqués à une classe de fabrique de zones de formulaire nommée myFormRegion.Le premier attribut associe la zone de formulaire à une classe de message standard pour un formulaire de message électronique.Le deuxième associe la zone de formulaire à une classe de message personnalisée nommée 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)
    {
    }
}

Les attributs doivent respecter les recommandations suivantes :

  • Pour les classes de message personnalisées, utilisez le nom de classe de message qualifié complet (par exemple, « IPM.Note.Contoso »).

  • Ne spécifiez pas la classe de message de base seule (par exemple : « IPM »).

  • Les noms de classe de message ne doivent pas dépasser 256 caractères.

  • N'incluez pas les noms de classes de message standard si la zone de formulaire remplace l'ensemble du formulaire ou la page par défaut d'un formulaire.Vous pouvez spécifier des noms de classe de message standard uniquement pour les formulaires qui ajoutent une nouvelle page à un formulaire ou qui sont ajoutés à la fin d'un formulaire.Pour plus d’informations, consultez Comment : ajouter une zone de formulaire à un projet de complément Outlook.

Visual Studio valide le format des noms de classes de message lorsque vous générez le projet.

[!REMARQUE]

Visual Studio ne vérifie pas que les noms de classes de message que vous fournissez sont corrects ou valides.

Voir aussi

Tâches

Procédure pas à pas : conception d'une zone de formulaire Outlook

Référence

Sur le nom et la classe de message de formulaire

comment les formulaires Outlook et les éléments fonctionnent ensemble

Concepts

Accès à une zone de formulaire au moment de l'exécution

Directives pour la création de zones de formulaire Outlook

Autres ressources

Création de zones de formulaire Outlook