Création de zones de formulaire Outlook

Article
04/28/2010

Mise à jour : novembre 2007

S'applique à
Les informations de cette rubrique s'appliquent uniquement aux projets Visual Studio Tools pour Office et aux versions de Microsoft Office spécifiés. Type de projet Projets au niveau de l'application Version de Microsoft Office Outlook 2007 Pour plus d'informations, consultez Fonctionnalités disponibles par type d'application et de projet.

Les informations de cette rubrique s'appliquent uniquement aux projets Visual Studio Tools pour Office et aux versions de Microsoft Office spécifiés.

Type de projet

Projets au niveau de l'application

Version de Microsoft Office

Outlook 2007

Pour plus d'informations, consultez Fonctionnalités disponibles par type d'application et de projet.

Vous pouvez utiliser des zones de formulaire pour personnaliser des formulaires Microsoft Office Outlook. Visual Studio Tools pour Office fournit des outils avancés qui facilitent la conception, le développement et le débogage de zones de formulaire.

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. De plus, si vous disposez d'une zone de formulaire que vous avez utilisée dans un autre projet de complément Visual Studio Tools pour Office, vous pouvez la réutiliser.

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 avez exécuté l'Assistant Nouvelle zone de formulaire Outlook, Visual Studio Tools pour Office 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.

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

Vous pouvez réutiliser dans votre projet de complément Outlook actuel une zone de formulaire Outlook utilisée dans un autre projet Visual Studio Tools pour Office à 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 plus d'informations, consultez Comment : créer des gestionnaires d'événements dans l'éditeur de code Visual Basic.

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.

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 types qui utilisent le modèle objet d'Outlook dans Visual Studio Tools pour Office, 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 Tools pour Office ajoute les informations suivantes au 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 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 le débogueur Visual Studio, Visual Studio Tools pour Office 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 à 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 de solutions Office (Office System 2007).