Création de zones de formulaire Outlook

Vous pouvez utiliser des zones de formulaire pour personnaliser des formulaires Microsoft Office Outlook.Visual Studio fournit des outils avancés qui simplifient la conception, le développement et le débogage des 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.

Cette rubrique fournit les informations suivantes :

• Avantages de l'utilisation des zones de formulaire

• Ajout d'une zone de formulaire Outlook à votre projet

• Utilisation du Concepteur de zones de formulaire

• Utilisation d'une zone de formulaire conçue dans Outlook

• Ajout de code personnalisé à une zone de formulaire

• Génération du projet

• Débogage d'une zone de formulaire

• Déploiement d'une zone de formulaire

Avantages de l'utilisation des zones de formulaire

Les zones de formulaire offrent de nombreuses améliorations par rapport au développement de formulaires Outlook classiques :

• Personnaliser la page par défaut de tout formulaire standard.

• Ajouter jusqu'à 12 pages supplémentaires à tout formulaire standard.

• Remplacer ou améliorer tout formulaire standard.

• Afficher l'interface utilisateur personnalisée dans le volet de lecture et dans les Inspecteurs.

Pour plus d'informations, consultez Personnalisation des pages et zones de formulaire.

Ajout d'une zone de formulaire Outlook à votre projet

Vous pouvez utiliser l'Assistant Nouvelle zone de formulaire Outlook pour concevoir une nouvelle zone de formulaire ou importer une zone de formulaire conçue dans Outlook.Si vous avez utilisé une zone de formulaire dans un autre projet de complément Outlook, vous pouvez réutiliser votre zone de formulaire existante.

Création d'une zone de formulaire à l'aide de l'Assistant

Pour créer une zone de formulaire, ajoutez un élément Zone de formulaire Outlook à un projet de complément Outlook.L'Assistant Nouvelle zone de formulaire Outlook démarre.

Utilisez l'Assistant pour indiquer si vous souhaitez concevoir une nouvelle zone de formulaire ou importer une zone conçue dans Outlook.Pour plus d'informations sur la conception d'une nouvelle zone de formulaire, consultez Utilisation du Concepteur de zones de formulaire.Pour plus d'informations sur l'utilisation d'une zone de formulaire conçue dans Outlook, consultez Importation d'une zone de formulaire conçue dans Outlook.

Utilisez l'Assistant pour spécifier le type de zone de formulaire à créer.Le tableau suivant décrit chaque type de zone de formulaire.

Type de zone	Description
Séparer	Ajoute la zone de formulaire comme nouvelle page dans un formulaire Outlook.
Adjacent	Ajoute la zone de formulaire au bas de la page par défaut d'un formulaire Outlook.
Replacement	Ajoute la zone de formulaire comme nouvelle page qui remplace la page par défaut d'un formulaire Outlook.
Remplacement global	Remplace l'intégralité du formulaire Outlook par la zone de formulaire.

Vous pouvez également utiliser l'Assistant pour spécifier des conditions d'affichage et sélectionner le type de formulaire à étendre.Pour plus d’informations, consultez Comment : ajouter une zone de formulaire à un projet de complément Outlook.

Les sélections effectuées dans l'Assistant affectent les options disponibles dans d'autres pages de l'Assistant.Par exemple, si vous sélectionnez Adjacent ou Séparer sur la page Créer une zone de formulaire Outlook, les champs Titre et Description ne sont pas disponibles sur la page Fournissez un texte descriptif et sélectionnez vos préférences d'affichage.Cela tient au fait qu'Outlook n'utilise pas ces champs lorsqu'il affiche une zone de formulaire adjacente ou distincte.

Fichiers de la zone de formulaire

Lorsque vous terminez l'Assistant Nouvelle zone de formulaire Outlook, Visual Studio ajoute automatiquement les fichiers suivants à votre projet :

• Un fichier de code de zone de formulaire.Ce fichier porte le nom spécifié pour l'élément Zone de formulaire Outlook dans la boîte de dialogue Ajouter un nouvel élément.Ajoutez à ce fichier du code permettant de gérer les événements de la zone de formulaire.

• Un fichier de code du Concepteur de zones de formulaire.Ce fichier contient du code généré par le Concepteur de zones de formulaire et ne doit pas être modifié directement.

• Un fichier de stockage de formulaire Outlook (.ofs).

  [!REMARQUE]

  Ce fichier est ajouté au projet uniquement si vous importez une zone de formulaire conçue dans Outlook.

Classe de fabrique de zones de formulaire

Le fichier de code de la zone de formulaire contient une classe partielle qui implémente l'interface IFormRegionFactory.Il s'agit de la classe de fabrique de zones de formulaire.La classe de fabrique de zones de formulaire est chargée de créer de nouvelles instances de la zone de formulaire.

Pour y accéder, développez la région Fabrique de zones de formulaire.

L'Assistant Nouvelle zone de formulaire Outlook ajoute à cette classe des attributs qui spécifient le nom interne de la zone de formulaire et les classes de message qui affichent la zone de formulaire.Vous pouvez modifier ces attributs manuellement après avoir ajouté le fichier au projet.

La plus grande partie de la classe de fabrique de zones de formulaire est implémentée dans le fichier du Concepteur de zones de formulaire.Toutefois, le gestionnaire d'événements FormRegionInitializing est exposé dans le fichier de code de la zone de formulaire.Vous pouvez l'utiliser pour indiquer si Outlook doit afficher la zone de formulaire.Pour plus d'informations, consultez Gestion des événements de la zone de formulaire.

Ajout d'une zone de formulaire existante à votre projet

Si vous avez utilisé une zone de formulaire Outlook dans un autre projet Outlook, vous pouvez la réutiliser dans votre projet de complément Outlook actuel à l'aide de la boîte de dialogue Ajouter un élément existant.

La zone de formulaire existante doit posséder un fichier de code (.vb ou .cs) ; vous ne pouvez pas ajouter de fichiers de stockage de formulaire Outlook (.ofs) à l'aide de la boîte de dialogue Ajouter un élément existant.Toutefois, vous pouvez créer une zone de formulaire en important un fichier de stockage de formulaire Outlook.Pour plus d’informations, consultez Comment : ajouter une zone de formulaire à un projet de complément Outlook.

Utilisation du Concepteur de zones de formulaire

Le Concepteur de zones de formulaire vous permet de concevoir la disposition et l'apparence d'une zone de formulaire.Vous pouvez faire glisser des contrôles managés sur la surface du Concepteur, double-cliquer sur des contrôles pour ouvrir des gestionnaires d'événements et définir des propriétés dans la fenêtre Propriétés.

[!REMARQUE]

Vous pouvez accéder sous le nœud Manifeste de la fenêtre Propriétés à des propriétés qui affectent l'affichage de la zone de formulaire apparaît dans Outlook.

Le Concepteur de zones de formulaire est disponible uniquement si vous sélectionnez Créer une nouvelle zone de formulaire sur la page Sélectionnez la méthode de création de la zone de formulaire de l'Assistant Nouvelle zone de formulaire Outlook.

Il existe trois méthodes pour ouvrir le Concepteur de zones de formulaire :

• Dans l'Explorateur de solutions, double-cliquez sur le fichier de code de la zone de formulaire.

• Dans l'Explorateur de solutions, cliquez avec le bouton droit sur le fichier de code de la zone de formulaire et sélectionnez Concepteur de vues.

• Dans l'Explorateur de solutions, sélectionnez le fichier de code de la zone de formulaire, puis cliquez sur Concepteur dans le menu Affichage.

Le Concepteur de zones de formulaire ne prend en charge que les contrôles managés.Vous ne pouvez pas ajouter de contrôles Outlook natifs.

Importation d'une zone de formulaire conçue dans Outlook

Lors d'une conception dans Outlook, vous pouvez ajouter des contrôles Outlook natifs à la zone de formulaire.Les contrôles Outlook natifs vous permettent de créer une liaison avec les données Outlook au moment du design.Toutefois, vous ne pouvez pas utiliser ensuite le Concepteur de zones de formulaire pour ajouter des contrôles managés ou modifier la conception de la zone de formulaire.

Vous pouvez importer des zones de formulaire dans un projet de complément Outlook à l'aide de l'Assistant Nouvelle zone de formulaire Outlook.Sur la page Sélectionnez la méthode de création de la zone de formulaire, sélectionnez Importer un fichier de stockage de formulaire Outlook (.ofs).Vous pouvez ensuite accéder à l'emplacement d'un fichier de stockage de formulaire Outlook (.ofs).(Outlook enregistre les zones de formulaire au format .ofs.)

L'Assistant Nouvelle zone de formulaire Outlook copie le fichier .ofs dans le répertoire de projet et ajoute des références de contrôle au fichier du Concepteur de zones de formulaire.Vous pouvez ensuite gérer des événements de contrôle dans le fichier de code de la zone de formulaire.

Pour gérer des événements dans un projet Visual Basic, sélectionnez un événement dans la liste de noms de méthode en haut de l'éditeur de code.

Pour gérer des événements dans un projet C#, abonnez-vous à des événements de contrôle dans la méthode FormRegionShowing.Pour plus d’informations, consultez Comment : s'abonner et annuler l'abonnement à des événements (Guide de programmation C#).

Vous pouvez modifier les propriétés des zones de formulaire dans la méthode InitializeManifest de la classe de fabrique de zones de formulaire.

[!REMARQUE]

Pour importer une zone de formulaire, vous devez utiliser un projet qui cible la même version d'Outlook que celle installée sur l'ordinateur de développement.Par exemple, si Outlook 2010 est installé, l'importation d'une zone de formulaire fonctionnera uniquement dans un projet créé à l'aide du modèle de projet Complément Outlook 2010.

Mise à jour de la conception d'une zone de formulaire importée

Vous pouvez ajouter, supprimer ou modifier des contrôles sur la zone de formulaire.Avant cela, sauvegardez tout le code que vous avez ajouté au fichier de code de la zone de formulaire.Ouvrez ensuite le fichier .ofs dans Outlook, modifiez la zone de formulaire, puis enregistrez les modifications.Utilisez l'Assistant Nouvelle zone de formulaire Outlook pour importer le fichier .ofs modifié.Vous pouvez ensuite coller votre code dans le nouveau fichier de code de la zone de formulaire.

Ajout de code personnalisé à une zone de formulaire

L'espace de noms Microsoft.Office.Tools.Outlook vous donne accès à des classes qui représentent la zone de formulaire, l'élément Outlook qui affiche la zone de formulaire et d'autres éléments utiles.L'élément Zone de formulaire Outlook ajoute automatiquement une référence à cet assembly dans le projet et insère l'instruction using ou Imports appropriée au début du fichier de code de la zone de formulaire.

Vous pouvez utiliser des classes, des méthodes et des propriétés dans l'espace de noms Microsoft.Office.Interop.Outlook pour accomplir la plupart de vos tâches de programmation Outlook.Pour plus d'informations sur le modèle objet d'Outlook, consultez Vue d'ensemble du modèle d'objet Outlook.Pour obtenir des exemples de tâches typiques utilisant le modèle objet Outlook, consultez Solutions Outlook.

Gestion des événements de la zone de formulaire

L'élément Zone de formulaire Outlook ajoute automatiquement les trois gestionnaires d'événements suivants au fichier de code de la zone de formulaire.

Événement	Description
FormRegionInitializing	Se produit avant l'initialisation de la zone de formulaire.Vous pouvez vérifier des conditions dans ce gestionnaire d'événements pour déterminer si Outlook doit afficher la zone de formulaire.Pour plus d’informations, consultez Comment : empêcher Outlook d'afficher une zone de formulaire.
FormRegionShowing	Se produit une fois qu'une instance de la zone de formulaire a été créée mais avant que la zone de formulaire n'apparaisse.
FormRegionClosed	Se produit avant la fermeture de la zone de formulaire.

Génération du projet

Lorsque vous générez un projet de complément Outlook qui contient une zone de formulaire, Visual Studio ajoute au Registre les informations suivantes :

• Une clé pour chaque classe de message associée à une ou plusieurs zones de formulaire

• Une entrée pour chaque zone de formulaire et une valeur associée représentant le nom du complément Outlook.

Outlook utilise ces informations pour charger les zones de formulaire.

Débogage d'une zone de formulaire

Pou déboguer un complément Outlook contenant une zone de formulaire, procéder comme pour les autres projets Visual Studio.Lorsque vous démarrez Visual Studio, Visual Studio lance automatiquement Outlook.

Pour afficher la zone de formulaire, vous devez ouvrir l'élément Outlook approprié.Par exemple, si une zone de formulaire adjacente est ajoutée à la fin d'un élément de messagerie, ouvrez un élément de messagerie.

Déploiement d'une zone de formulaire

Les zones de formulaire sont déployées automatiquement avec le complément Outlook associé.Le déploiement d'une zone de formulaire ne nécessite donc pas l'exécution de tâches spéciales.Pour plus d'informations sur le déploiement de compléments, consultez Déploiement d'une solution Office.

Rubriques connexes

Titre	Description
Directives pour la création de zones de formulaire Outlook	Fournit des informations qui peuvent vous aider à optimiser vos zones de formulaire et à éviter d'éventuels problèmes.
Comment : ajouter une zone de formulaire à un projet de complément Outlook	Montre comment créer une zone de formulaire permettant d'étendre un formulaire Microsoft Office Outlook standard ou personnalisé à l'aide de l'Assistant Nouvelle zone de formulaire Outlook.
Association d'une zone de formulaire à une classe de message Outlook	Explique comment spécifier les éléments de Microsoft Office Outlook devant afficher une zone de formulaire en associant la zone à la classe de message de chaque élément.
Procédure pas à pas : conception d'une zone de formulaire Outlook	Montre comment concevoir une zone de formulaire personnalisé qui apparaît comme un changement de page dans la fenêtre Inspecteur d'un élément de contact.
Procédure pas à pas : importation d'une zone de formulaire conçue dans Outlook	Montre comment concevoir une zone de formulaire dans Microsoft Office Outlook, puis importer la zone de formulaire dans un projet de complément Outlook en utilisant l'Assistant Nouvelle zone de formulaire Outlook.
Accès à une zone de formulaire au moment de l'exécution	Explique comment écrire du code permettant d'afficher, de masquer ou de modifier des contrôles dans une zone de formulaire et comment permettre aux utilisateurs d'exécuter du code à partir d'autres zones de votre projet à l'aide de la classe Globals.
Comment : empêcher Outlook d'afficher une zone de formulaire	Montre comment empêcher Microsoft Office Outlook d'afficher une zone de formulaire pour un élément particulier.
Montre comment accéder à l'élément Outlook dans lequel la zone de formulaire apparaît.
Actions personnalisées dans les zones de formulaire Outlook	Explique comment permettre aux utilisateurs de répondre à un élément Outlook.