Utilisation de contrôles WPF dans les solutions Office

Mise à jour : novembre 2007

Windows Presentation Foundation (WPF) est une alternative à Windows Forms pour concevoir des interfaces utilisateur. WPF utilise un langage de balisage appelé XAML (Extensible Application Markup Language) pour fournir de nouvelles techniques permettant d'incorporer l'interface utilisateur, des médias et des documents. Pour plus d'informations, consultez Introduction à Windows Presentation Foundation.

Bien que les solutions Visual Studio Tools pour Office soient conçues pour fonctionner avec des contrôles Windows Forms, vous pouvez également utiliser des contrôles WPF dans vos solutions. Tout élément d'interface utilisateur pouvant héberger des contrôles Windows Forms dans une solution Visual Studio Tools pour Office peut également héberger des contrôles WPF. Ces éléments sont les suivants :

  • Documents et feuilles de calcul dans les personnalisations au niveau du document.

  • Volets Actions dans les personnalisations au niveau du document.

  • Volets de tâches personnalisés dans les compléments au niveau de l'application.

  • Zones de formulaires dans les compléments au niveau de l'application pour Outlook.

Ajout de contrôles WPF à des projets Visual Studio Tools pour Office au moment du design

Vous ne pouvez pas ajouter directement des contrôles WPF aux éléments d'interface dans les solutions Visual Studio Tools pour Office. Ajoutez plutôt un élément Contrôle utilisateur (WPF) à votre projet et utilisez-le comme aire de conception pour les contrôles WPF. Ajoutez ensuite le contrôle utilisateur WPF à un élément d'interface utilisateur dans votre projet.

Pour ajouter des contrôles WPF à un volet Actions, un volet de tâches personnalisé ou une zone de formulaire

  1. Ouvrez un projet auquel vous souhaitez ajouter un volet de tâches personnalisé, un volet Actions ou une zone de formulaire.

  2. Ajoutez un élément Contrôle utilisateur (WPF) à votre projet.

  3. Dans la Boîte à outils, ajoutez des contrôles WPF à l'aire de conception du contrôle utilisateur WPF.

    Par défaut, lorsque le concepteur du contrôle utilisateur WPF est ouvert, la Boîte à outils contient uniquement des contrôles WPF.

  4. Générez le projet.

  5. Ajoutez un volet Actions, une zone de formulaire ou un volet de tâches personnalisé à votre projet :

  6. Dans l'onglet NomProjet Contrôles utilisateur WPF de la Boîte à outils, faites glisser le contrôle utilisateur WPF vers le concepteur pour le volet Actions, la zone de formulaire ou le volet de tâches personnalisé.

    Visual Studio crée automatiquement un objet ElementHost qui héberge le contrôle utilisateur WPF sur l'élément d'interface utilisateur.

  7. Régénérez le projet.

Pour ajouter des contrôles WPF à un document ou une feuille de calcul dans un projet au niveau du document

  1. Ouvrez un projet au niveau du document pour Word ou Excel.

  2. Ajoutez un élément Contrôle utilisateur (WPF) à votre projet.

  3. Dans la Boîte à outils, ajoutez des contrôles WPF à l'aire de conception du contrôle utilisateur WPF.

  4. Générez le projet.

  5. Ajoutez au projet un élément Contrôle utilisateur (c'est-à-dire, un contrôle utilisateur Windows Forms).

  6. Ouvrez le concepteur pour le contrôle utilisateur Windows Forms.

  7. Dans l'onglet NomProjetContrôles utilisateur WPF de la Boîte à outils, faites glisser le contrôle utilisateur WPF vers le concepteur.

    Visual Studio crée automatiquement un objet ElementHost qui héberge le contrôle utilisateur WPF dans le contrôle utilisateur Windows Forms.

  8. Écrivez du code qui ajoute par programme le contrôle utilisateur Windows Forms au document ou au classeur. Pour plus d'informations, consultez Ajout de contrôles à des documents Office au moment de l'exécution.

    Remarque :

    Vous ne pouvez pas faire glisser le contrôle utilisateur Windows Forms vers le document ou la feuille de calcul dans le concepteur.

  9. Régénérez le projet.

Hébergement de contrôles WPF à l'aide de la classe ElementHost

Visual Studio Tools pour Office fournit des fonctionnalités qui vous aident à utiliser des contrôles Windows Forms dans vos solutions, mais il ne fournit pas de fonctionnalités semblables pour les contrôles WPF. Par exemple, vous pouvez ajouter des contrôles Windows Forms aux documents et aux feuilles de calcul au moment du design en faisant glisser des contrôles de la Boîte à outils, ou au moment de l'exécution en utilisant des méthodes d'assistance. Toutefois, ces outils ne sont pas disponibles pour les contrôles WPF.

Les contrôles WPF utilisent la classe ElementHost comme une couche d'intégration entre un contrôle ou un formulaire Windows Forms et les contrôles WPF. La classe ElementHost est fournie par le .NET Framework, à partir de la version 3.0.

Lorsque vous ajoutez des contrôles WPF à votre solution au moment du design, Visual Studio génère automatiquement un objet ElementHost pour vous. Pour une procédure pas à pas qui montre comment utiliser la classe ElementHost par programme, consultez Comment : héberger un contrôle Windows Presentation Foundation dans les Windows Forms à l'aide d'ElementHost.

Ressources WPF

Pour plus d'informations sur les problèmes d'architecture et de conception pour héberger des contrôles WPF sur des contrôles et des formulaires Windows Forms, consultez les rubriques suivantes :

Pour plus d'informations sur l'ajout de contrôles WPF à des contrôles et des formulaires Windows Forms dans Visual Studio au moment du design, consultez les rubriques suivantes :

Voir aussi

Tâches

Comment : ajouter un volet Actions à des documents Word

Comment : ajouter un volet Actions à des classeurs Excel

Comment : ajouter un volet de tâches personnalisé à une application

Comment : ajouter une zone de formulaire à un projet de complément Outlook

Concepts

Personnalisation de l'interface utilisateur Office

Vue d'ensemble des contrôles Windows Forms dans les documents Office

Vue d'ensemble du volet Actions

Vue d'ensemble des volets de tâches personnalisés

Création de zones de formulaire Outlook

  • Last updated on