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

Mise à jour : novembre 2007

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 exécutez 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.

Remarque :

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 Paramètres Visual Studio.

Composants requis

Vous avez besoin des composants suivants pour exécuter cette procédure pas à pas :

  • Visual Studio 2008.

Création du projet

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

Remarque :

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é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.

Remarque :

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

  1. Dans l'Explorateur de solutions, ajoutez un nouvel élément Contrôle utilisateur (WPF) au projet. Utilisez le nom par défaut pour le type de contrôle, UserControl1. Pour plus d'informations, consultez Comment : ajouter et supprimer des éléments de solution. Utilisez le nom par défaut, UserControl1.xaml.

    L'ajout du nouveau contrôle a les effets suivants.

    • Le fichier UserControl1.xaml est ajouté au projet.

    • Le fichier UserControl1.xaml.cs ou UserControl1.xaml.vb est ajouté au projet. 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 au projet.

    • Le fichier UserControl1.xaml s'ouvre dans le Concepteur Windows Presentation Foundation (WPF) pour Visual Studio.

  2. 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.

  3. Dans la fenêtre Propriétés, affectez aux propriétés Width et Height la valeur 200.

  4. Depuis la Boîte à outils, faites glisser un contrôle System.Windows.Controls.TextBox vers l'aire de conception.

  5. Dans la fenêtre Propriétés, modifiez la valeur de la propriété Text en lui affectant la valeur Contenu hébergé.

    Remarque :

    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.

  6. 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

  1. Ouvrez Form1 dans le Concepteur Windows Forms.

  2. Dans la Boîte à outils, recherchez l'onglet étiqueté HostingWpf contrôles utilisateur WPF.

  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 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.

  4. Dans le panneau des balises actives Tâches ElementHost, sélectionnez Ancrer 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

Référence

ElementHost

WindowsFormsHost

Autres ressources

Migration et interopérabilité

Utilisation des contrôles Windows Presentation Foundation

Concepteur WPF