Comment : créer un projet de bibliothèque UserControl WPF

Article
08/21/2008

Mise à jour : novembre 2007

Pour combiner les fonctionnalités d'un ou plusieurs contrôles Windows Presentation Foundation (WPF) avec du code personnalisé, vous pouvez créer un contrôle utilisateur, également connu sous le nom de contrôle composite. Les contrôles utilisateur allient le développement rapide de contrôle aux fonctionnalités standard WPF et à la polyvalence des propriétés et des méthodes personnalisées. Lorsque vous commencez à créer un contrôle utilisateur, vous voyez apparaître un concepteur visuel dans lequel vous pouvez disposer des contrôles WPF standard. Les contrôles enfants sont connus sous le nom de contrôles constituants.

Ces contrôles constituants conservent toutes leurs fonctionnalités inhérentes, aussi bien que l'apparence et le comportement (apparence et convivialité) de contrôles WPF standard. Une fois que ces contrôles sont construits dans le contrôle utilisateur, toutefois, ils ne sont plus disponibles à vous à travers le code. Le contrôle utilisateur effectue sa propre peinture et gère également toutes les fonctionnalités élémentaires associées aux contrôles.

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.

Pour créer un projet Contrôle utilisateur WPF

Démarrez une version de Visual Studio qui prend en charge le développement WPF, telle que Visual Studio 2008.
Dans le menu Fichier, pointez sur Nouveau, puis cliquez sur Projet. La boîte de dialogue Nouveau projet s'affiche.
Dans le volet Types de projets, choisissez le langage de programmation que vous souhaitez utiliser.

Dans le volet Modèles, choisissez Bibliothèque de contrôles utilisateur WPF pour des projets Visual Basic ou Visual C#. Plus d'informations à propos du modèle sélectionné sont affichées au-dessous des volets Types de projets et Modèles.

Remarque :
Si vous ne voyez pas le modèle Bibliothèque de contrôles utilisateur WPF, assurez-vous que vous ciblez une version du .NET Framework qui prend en charge WPF. Dans le coin supérieur droit de la boîte de dialogue Nouveau projet, la liste déroulante de version du .NET Framework doit prendre la valeur .NET Framework 3.0 ou version ultérieure.

Dans la zone Nom, tapez un nom unique pour le projet indiquant le but du contrôle.
Dans la zone de texte Emplacement, entrez le répertoire dans lequel vous désirez enregistrer votre projet ou bien cliquez sur le bouton Parcourir pour naviguer jusqu'à lui.

Cliquez sur OK. Le Concepteur Windows Presentation Foundation (WPF) pour Visual Studio s'ouvre, affichant UserControl1 du projet que vous avez créé.

Remarque pour Visual Basic :
Tous les fichiers exécutables créés à l'aide de Visual Basic 2005 contiennent un espace de noms portant le même nom que votre projet. Pour plus d'informations, consultez Espaces de noms dans Visual Basic.

Faites glisser des contrôles depuis la Boîte à outils sur votre contrôle utilisateur.

Modifiez la position et l'apparence de ces contrôles en fonction de la façon dont vous voulez les voir apparaître dans le contrôle utilisateur final. Si vous voulez que les contrôles constitutifs du contrôle utilisateur soient accessibles aux développeurs, déclarez-les comme publics ou exposez sélectivement leurs propriétés.