Partager via

Utiliser les contrôles WPF dans les solutions Office

  • 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, voir Vue d’ensemble de WPF.

S'applique à : les informations contenues dans cette rubrique s'appliquent aux projets de niveau document et aux projets de compléments VSTO. Consultez les caractéristiques disponibles par application Office et par 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.

Ajoutez des contrôles WPF aux projets Office au moment de la conception.

Vous ne pouvez pas ajouter des contrôles WPF directement aux éléments d'interface utilisateur dans les solutions Office. Pour cela, ajoutez un élément User Control (WPF) à votre projet et utilisez-le comme surface 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 contrôle utilisateur (WPF) à votre projet.

  3. Dans la boîte à outils, ajoutez des contrôles WPF à la surface de conception du contrôle utilisateur WPF.

    Par défaut, lorsque le concepteur de contrôle utilisateur WPF est ouvert, la boîte à outils ne contient que 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. Dans l'onglet Nom du projet Contrôles utilisateur WPF de la Boîte à outils, faites glisser le contrôle utilisateur WPF vers le concepteur du volet d'actions, de la région de formulaire ou du volet de tâches personnalisées.

    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 contrôle utilisateur (WPF) à votre projet.

  3. Dans la boîte à outils, ajoutez des contrôles WPF à la surface de conception du contrôle utilisateur WPF.

  4. Créez le projet.

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

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

  7. Dans l'onglet Nom du projet Contrô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 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 aux 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 du concepteur .

  9. Regénérez le projet.

Héberger des contrôles WPF en utilisant 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 aux documents et aux feuilles de calcul au moment de la conception en faisant glisser des contrôles depuis la boîte à outils, ou au moment de l'exécution en utilisant des méthodes d'aide. 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