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

Article
08/10/2011

Cette rubrique vous indique comment créer un contrôle WPF (Windows Presentation Foundation) pour une utilisation dans vos applications Windows Forms.

Dans cette procédure pas à pas, vous allez effectuer les tâches suivantes :

créer le projet ;
créer un contrôle WPF ;
ajouter le nouveau contrôle WPF à un Windows Form. Le contrôle WPF est hébergé dans un contrôle ElementHost.

Notes

Les boîtes de dialogue et les commandes de menu qui s'affichent peuvent être différentes de celles qui sont décrites dans l'aide, en fonction de vos paramètres actifs ou de l'édition utilisée. Pour modifier vos paramètres, choisissez Importation et exportation de paramètres dans le menu Outils. Pour plus d'informations, consultez Utilisation des paramètres.

Composants requis

Pour exécuter cette procédure pas à pas, vous devez disposer des composants suivants :

Visual Studio 2008.

Création du projet

La première étape consiste à créer le projet Windows Forms.

Notes

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

Pour créer le projet

Créez un projet Application Windows Forms dans Visual Basic ou Visual C# nommé HostingWpf. Pour plus d'informations, consultez Comment : créer un projet d'Application Windows Forms.

Création d'un contrôle WPF

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

Notes

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

Pour créer un contrôle WPF

Dans l'Explorateur de solutions, ajoutez à la solution un nouveau projet Bibliothèque de contrôles utilisateur WPF. Utilisez le nom par défaut pour la bibliothèque de contrôles, WpfControlLibrary1. Le nom par défaut du contrôle 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.
En mode Design, assurez-vous que UserControl1 est sélectionné. Pour plus d'informations, consultez Comment : sélectionner et déplacer des éléments sur l'aire de conception.
Dans la fenêtre Propriétés, affectez aux propriétés Width et Height la valeur 200.
Depuis la Boîte à outils, faites glisser un contrôle System.Windows.Controls.TextBox vers l'aire de conception.
Dans la fenêtre Propriétés, modifiez la valeur de la propriété Text en lui affectant la valeur Contenu hébergé.

Notes

En général, vous devez héberger un contenu WPF plus sophistiqué. Le contrôle System.Windows.Controls.TextBox est uniquement utilisé ici à des fins d'illustration.
Générez le projet.

Ajout d'un contrôle WPF à un Windows Form

Votre nouveau contrôle WPF est prêt pour une utilisation sur le formulaire. Les Windows Forms utilisent le contrôle ElementHost pour héberger le contenu de WPF.

Pour ajouter un contrôle WPF à un Windows Form

Ouvrez Form1 dans le Concepteur Windows Forms.
Dans la Boîte à outils, ouvrez l'onglet Contrôles utilisateur WPF WPFUserControlLibrary.
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 contrôle ElementHost est nommé elementHost1 et dans la fenêtre Propriétés, vous pouvez voir que sa propriété Child a la valeur UserControl1.
- Les références aux assemblys WPF sont ajoutées au projet.
- Le contrôle elementHost1 a un panneau des balises actives qui affiche les options d'hébergement disponibles.
Dans le panneau des balises actives Tâches ElementHost, sélectionnez Ancrer dans le conteneur parent.
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.