Créer des 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 complément VSTO pour Outlook. Pour plus d’informations, consultez Fonctionnalités disponibles par application Office lication et le type de projet.
Cette rubrique fournit les informations suivantes :
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 :
personnalisation de la page par défaut de n'importe quel formulaire standard,
ajout d'un maximum de 12 pages supplémentaires à n'importe quel formulaire standard,
remplacement ou amélioration de n'importe quel formulaire standard,
affichage de l'interface utilisateur personnalisée dans le volet de lecture et dans les inspecteurs.
Pour plus d’informations, consultez Personnaliser les pages de formulaire et les zones de formulaire.
Ajouter 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. En outre, si vous disposez d'une zone de formulaire que vous avez utilisée dans un autre projet de complément VSTO Outlook, vous pouvez réutiliser votre zone de formulaire existante.
Créer une zone de formulaire à l’aide de l’Assistant
Pour créer une zone de formulaire, ajoutez un élément de zone de formulaire Outlook à un projet de complément VSTO Outlook. L’Assistant Nouvelle zone de formulaire Outlook démarre.
Utilisez cet Assistant pour indiquer si vous voulez concevoir une nouvelle zone de formulaire ou importer une zone de formulaire conçue dans Outlook. Pour plus d’informations sur la conception d’une nouvelle zone de formulaire, consultez Utiliser le concepteur de zones de formulaire. Pour plus d’informations sur l’utilisation d’une zone de formulaire conçue dans Outlook, consultez Importer une zone de formulaire conçue dans Outlook.
Utilisez l'Assistant pour spécifier le type de zone de formulaire que vous souhaitez créer. Le tableau suivant décrit chaque type de zone de formulaire.
| Type de région | Description |
|---|---|
| Séparé | Ajoute la zone de formulaire en tant que nouvelle page dans un formulaire Outlook. |
| Adjacent | Ajoute la zone de formulaire au bas de la page par défaut d'un formulaire Outlook. |
| Remplacement | Ajoute la zone de formulaire en tant que 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 les conditions d'affichage et sélectionner le type de formulaire à étendre. Pour plus d’informations, consultez Guide pratique pour ajouter une zone de formulaire à un projet de complément Outlook.
Les sélections que vous effectuez dans l'Assistant affectent les options disponibles dans les autres pages de l'Assistant. Par exemple, si vous sélectionnez Adjacent ou Distinct dans la page Créer une zone de formulaire Outlook, les champs Titre et Description ne sont pas disponibles dans le texte descriptif Fournir et sélectionner votre page de préférences d’affichage. Cela tient au fait qu'Outlook n'utilise pas ces champs pour afficher une zone de formulaire adjacente ou distincte.
Fichiers de zone de formulaire
Lorsque vous avez terminé 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 que vous spécifiez pour l’élément zone de formulaire Outlook dans la boîte de dialogue Ajouter un nouvel élément . Ajoutez à ce fichier du code pour gérer les événements de zone de formulaire.
Un fichier de code du Concepteur de zones de formulaire. Ce fichier contient le code généré par le Concepteur de zones de formulaire et ne doit pas être modifié directement.
Fichier Stockage de formulaire Outlook (.ofs).
Remarque
Ce fichier est ajouté uniquement au projet si vous importez une zone de formulaire conçue dans Outlook.
Classe fabrique de zone 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. Cette classe est chargée de créer de nouvelles instances de la zone de formulaire.
Vous trouverez cette classe en développant la zone Fabrique de zone de formulaire.
L’Assistant Nouvelle zone de formulaire Outlook ajoute des attributs à cette classe 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 une fois que le fichier a été ajouté 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 utiliser ce gestionnaire d'événements pour spécifier si Outlook doit afficher la zone de formulaire. Pour plus d’informations, consultez Gérer les événements de zone de formulaire.
Ajouter une zone de formulaire existante à votre projet
Si vous disposez d'une zone de formulaire Outlook que vous avez utilisée dans un autre projet Outlook, vous pouvez la réutiliser dans votre projet de complément VSTO Outlook actuel à l'aide de la boîte de dialogue Ajouter un élément existant .
La zone de formulaire existante doit avoir un fichier de code (.vb ou .cs) ; vous ne pouvez pas ajouter de fichiers de formulaire Outlook Stockage (.ofs) à l’aide de la boîte de dialogue Ajouter un élément existant. Toutefois, vous pouvez créer une nouvelle zone de formulaire en important un fichier de stockage de formulaire Outlook. Pour plus d’informations, consultez Guide pratique pour ajouter une zone de formulaire à un projet de complément Outlook.
Utiliser le concepteur de zone de formulaire
Le Concepteur de zones de formulaire vous aide à concevoir la disposition et l'apparence d'une zone de formulaire. Vous pouvez faire glisser des contrôles managés vers l’aire 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 trouver des propriétés qui affectent la façon dont la zone de formulaire apparaît dans Outlook sous le nœud Manifeste dans la fenêtre Propriétés .
Le concepteur de zone de formulaire est disponible uniquement si vous sélectionnez Concevoir une nouvelle zone de formulaire dans la page Sélectionner la façon dont vous souhaitez créer la page zone de formulaire de l’Assistant Nouvelle zone de formulaire Outlook.
Il existe trois façons d'ouvrir le Concepteur de zones de formulaire :
Dans Explorateur de solutions, double-cliquez sur le fichier de code de zone de formulaire.
Dans Explorateur de solutions, cliquez avec le bouton droit sur le fichier de code de zone de formulaire, puis cliquez sur Concepteur de vues.
Dans Explorateur de solutions, sélectionnez le fichier de code de zone de formulaire, puis, dans le menu Affichage, cliquez sur Concepteur.
Le Concepteur de zones de formulaire prend en charge uniquement les contrôles managés. Vous ne pouvez pas ajouter de contrôles Outlook natifs.
Importer une zone de formulaire conçue dans Outlook
Quand vous concevez une zone de formulaire dans Outlook, vous pouvez lui ajouter des contrôles Outlook natifs. 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 VSTO Outlook à l’aide de l’Assistant Nouvelle zone de formulaire Outlook. Dans la page Sélectionner la façon dont vous souhaitez créer la page zone de formulaire, sélectionnez Importer un fichier de formulaire Outlook Stockage (.ofs). Vous pouvez ensuite accéder à l’emplacement d’un fichier de Stockage de formulaire Outlook (.ofs). (Outlook enregistre les zones de formulaire sous forme de fichiers .ofs .)
L’Assistant Nouvelle zone de formulaire Outlook copie le fichier .ofs dans le répertoire du projet et ajoute des références de contrôle au fichier concepteur de zone de formulaire. Vous pouvez ensuite gérer les événements de contrôle dans le fichier de code de région de formulaire.
Pour gérer des événements dans un projet Visual Basic, sélectionnez un événement dans la liste des noms de méthodes en haut de l'éditeur de code.
Pour gérer des événements dans un projet C#, abonnez-vous aux événements de contrôle dans la méthode FormRegionShowing. Pour plus d’informations, consultez Guide pratique pour s’abonner aux événements et se désabonner 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 travailler dans un projet qui cible la version d'Outlook que vous avez installée sur l'ordinateur de développement. Par exemple, si Outlook 2010 est installé, l’importation d’une zone de formulaire fonctionne uniquement dans un projet a été créée à l’aide du modèle de projet de complément Outlook 2010 .
Mettre à jour la conception d’une zone de formulaire importée
Vous pouvez ajouter, supprimer ou modifier des contrôles dans 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 fichier de code de la nouvelle zone de formulaire.
Ajouter du code personnalisé à une zone de formulaire
L'espace de noms Microsoft.Office.Tools.Outlook vous donne accès aux 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 appropriée à l’aide ou à l’instruction Imports en haut du fichier de code de 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 Outlook, consultez vue d’ensemble du modèle objet Outlook. Pour obtenir des exemples de tâches classiques qui utilisent le modèle objet Outlook, consultez les solutions Outlook.
Gérer les événements de zone de formulaire
L’élément Région de formulaire Outlook ajoute automatiquement les trois gestionnaires d’événements suivants au fichier de code de 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 Guide pratique pour empêcher Outlook d’afficher une zone de formulaire. |
| FormRegionShowing | Se produit après la création d'une instance de la zone de formulaire, mais avant l'affichage de la zone de formulaire. |
| FormRegionClosed | Se produit avant la fermeture de la zone de formulaire. |
Créer le projet
Quand vous générez un projet de complément VSTO Outlook qui contient une zone de formulaire, Visual Studio ajoute les informations suivantes dans le Registre :
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 VSTO Outlook.
Outlook utilise ces informations pour charger les zones de formulaire.
Déboguer une zone de formulaire
Vous pouvez déboguer un complément VSTO Outlook qui contient une zone de formulaire comme vous le feriez pour déboguer d’autres projets Visual Studio. Lorsque vous démarrez le débogueur Visual Studio, Visual Studio démarre 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 au bas d'un élément de messagerie, ouvrez un élément de messagerie.
Déployer une zone de formulaire
Les zones de formulaire sont déployées automatiquement avec le complément VSTO Outlook associé. Il est donc inutile d'exécuter des tâches spéciales pour déployer une zone de formulaire. Pour plus d’informations sur le déploiement de compléments VSTO, consultez Déployer une solution Bureau.
Rubriques connexes
| Intitulé | Description |
|---|---|
| Instructions pour créer des zones de formulaire Outlook | Fournit des informations pouvant vous aider à optimiser vos zones de formulaire et à éviter d'éventuels problèmes. |
| Guide pratique pour ajouter une zone de formulaire à un projet de complément Outlook | Montre comment créer une zone de formulaire pour étendre un formulaire Microsoft Bureau Outlook standard ou personnalisé à l’aide de l’Assistant Nouvelle zone de formulaire Outlook. |
| Associer une zone de formulaire à une classe de message Outlook | Explique comment spécifier les éléments Microsoft Office Outlook qui doivent afficher une zone de formulaire en associant cette dernière à la classe de message de chaque élément. |
| Procédure pas à pas : Concevoir une zone de formulaire Outlook | Montre comment concevoir une zone de formulaire personnalisée qui apparaît en tant que nouvelle page dans la fenêtre Inspecteur d'un élément de contact. |
| Procédure pas à pas : Importer une zone de formulaire conçue dans Outlook | Montre comment concevoir une zone de formulaire dans Microsoft Bureau Outlook, puis importer la zone de formulaire dans un projet de complément VSTO Outlook à l’aide de l’Assistant Nouvelle zone de formulaire Outlook. |
| Accéder à une zone de formulaire au moment de l’exécution | Explique comment écrire du code pour afficher, masquer ou modifier des contrôles dans une zone de formulaire, et comment permettre aux utilisateurs d'exécuter le code à partir d'autres zones de votre projet à l'aide de la classe Globals. |
| Guide pratique pour 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 une 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. |