Procédure pas à pas : créer du contenu WPF sur Windows Forms au moment du design

  • Article

Cet article vous montre comment créer un contrôle WPF (Windows Presentation Foundation) à utiliser dans vos applications Windows Forms.

Prérequis

Cette procédure pas à pas nécessite Visual Studio.

Créer le projet

Ouvrez Visual Studio et créez un projet d’application Windows Forms (.NET Framework) dans Visual Basic ou Visual C# nommé HostingWpf.

Remarque

Lors de l'hébergement de contenu WPF, seuls les projets Visual Basic et C# sont pris en charge.

Créer un contrôle WPF

La création d'un contrôle WPF et son ajout à votre projet sont des tâches aussi simples que l'ajout de tout autre élément à votre projet. Le Concepteur Windows Forms fonctionne avec un type particulier de contrôle nommé contrôle composite ou contrôle utilisateur. Pour plus d'informations sur les contrôles utilisateur WPF, consultez UserControl.

Remarque

Le type System.Windows.Controls.UserControl pour WPF est distinct du type de contrôle utilisateur fourni par Windows Forms, également nommé System.Windows.Forms.UserControl.

Pour créer un contrôle WPF :

  1. Dans Explorateur de solutions, ajoutez un nouveau projet wpF User Control Library (.NET Framework) à la solution. Utilisez le nom par défaut pour la bibliothèque de contrôles, WpfControlLibrary1. Le nom du contrôle par défaut est UserControl1.xaml.

    L’ajout du nouveau contrôle a les effets suivants :

    • Le fichier UserControl1.xaml est ajouté.

    • Le fichier UserControl1.xaml.cs (ou UserControl1.xaml.vb) est ajouté. Ce fichier contient le code-behind pour les gestionnaires d'événements et autre implémentation.

    • Les références aux assemblys WPF sont ajoutées.

    • Le fichier UserControl1.xaml s’ouvre dans le Concepteur WPF pour Visual Studio.

  2. En mode Design, assurez-vous que UserControl1 est sélectionné.

  3. Dans la fenêtre Propriétés, définissez la valeur des Width propriétés sur Height 200.

  4. À partir de la boîte à outils, faites glisser un System.Windows.Controls.TextBox contrôle sur l’aire de conception.

  5. Dans la fenêtre Propriétés , définissez la valeur de la Text propriété sur Contenu hébergé.

    Remarque

    En général, vous devez héberger du contenu WPF plus sophistiqué. Le contrôle System.Windows.Controls.TextBox est utilisé ici uniquement à titre d'illustration.

  6. Créez le projet.

Ajouter un contrôle WPF à un Windows Form

Votre nouveau contrôle WPF est prêt à être utilisé sur le formulaire. Windows Forms utilise le contrôle pour héberger du ElementHost contenu WPF.

Pour ajouter un contrôle WPF à un Windows Form :

  1. Ouvrez Form1 dans le Concepteur Windows Forms.

  2. Dans la boîte à outils, recherchez l’onglet intitulé WPFUserControlLibrary WPF User Controls.

  3. Faites glisser une instance de UserControl1 sur le formulaire.

    • Un contrôle ElementHost est créé automatiquement sur le formulaire pour héberger le contrôle WPF.

    • Le ElementHost contrôle est nommé elementHost1 et dans la fenêtre Propriétés , vous pouvez voir que sa Child propriété est définie sur UserControl1.

    • des références aux assemblys WPF sont ajoutées au projet.

    • Le contrôle elementHost1 a un panneau de Smart Tags qui affiche les options d’hébergement disponibles.

  4. Dans le panneau d’étiquettes actives ElementHost Tasks , sélectionnez Dock dans le conteneur parent.

  5. Appuyez sur F5 pour générer et exécuter l’application.

Étapes suivantes

Windows Forms et WPF sont des technologies différentes, mais elles sont conçues pour interagir étroitement. Pour fournir une apparence et un comportement plus riches dans vos applications, essayez les éléments suivants :

Voir aussi