Utiliser des contrôles WPF dans des solutions Bureau

  • Article

Bien que les solutions créées à l'aide des outils de développement Office dans Visual Studio soient conçues pour fonctionner directement avec les contrôles Windows Forms, vous pouvez également utiliser des contrôles WPF dans vos solutions. 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) qui offre de nouvelles techniques pour intégrer l'interface utilisateur, les médias et les documents. Pour plus d’informations, consultez la vue d’ensemble de WPF.

S’applique à : les informations contenues dans cette rubrique s’appliquent aux projets au niveau du document et aux projets de complément VSTO. Consultez les fonctionnalités disponibles par application Office lication et le type de projet.

Tout élément d'interface utilisateur qui peut héberger des contrôles Windows Forms dans une solution Office peut également héberger des contrôles WPF. Ces composants peuvent être notamment les suivants :

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

  • Les volets Actions dans les personnalisations au niveau du document.

  • Les volets de tâches personnalisés dans les compléments VSTO.

  • Les zones de formulaire dans les compléments VSTO pour Outlook.

Ajouter des contrôles WPF à Bureau projets au moment du design

Vous ne pouvez pas ajouter des contrôles WPF directement aux éléments d'interface utilisateur dans les solutions Office. Au lieu de cela, ajoutez un élément WPF (User Control) à votre projet et utilisez-le comme aire de conception pour les contrôles WPF. Puis, ajoutez le contrôle utilisateur WPF à un élément d'interface utilisateur de votre projet.

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

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

  2. Ajoutez un élément WPF (User Control) à votre projet.

  3. À partir de la boîte à outils, ajoutez des contrôles WPF à l’aire de conception du contrôle utilisateur WPF.

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

  4. Créez le projet.

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

  6. Sous l’onglet Contrôles utilisateur WPF ProjectNamede 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 Office 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. Regénérez le projet.

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

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

  2. Ajoutez un élément WPF (User Control) à votre projet.

  3. À partir de la boîte à outils, ajoutez des contrôles WPF à l’aire de conception du contrôle utilisateur WPF.

  4. Créez le projet.

  5. Ajoutez un élément de contrôle utilisateur (autrement dit, un contrôle utilisateur Windows Forms) au projet.

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

  7. Sous l’onglet Contrôles utilisateur WPF ProjectNamede 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 le code qui ajoute par programmation le contrôle utilisateur Windows Forms au document ou au classeur. Pour plus d’informations, consultez Ajouter des contrôles à Bureau documents 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 du concepteur .

  9. Regénérez le projet.

Héberger des contrôles WPF à l’aide de la classe ElementHost

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

Les contrôles WPF utilisent la classe ElementHost comme couche d'intégration entre un formulaire ou contrôle Windows Forms et les contrôles WPF. Lorsque vous ajoutez des contrôles WPF à votre solution au moment du design, Visual Studio génère automatiquement un objet ElementHost.

Ressources WPF

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

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

Contenu connexe