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

Article
08/10/2011

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.

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.

Pour créer un projet Contrôle utilisateur WPF

Démarrez Visual Studio 2010.
Dans le menu Fichier, pointez sur Nouveau, puis cliquez sur Projet.

La boîte de dialogue Nouveau projet s'affiche.
Dans le volet Modèles installés, développez Visual Basic ou Visual C# puis sélectionnez Windows.
Sélectionnez dans la liste déroulante des versions du .NET Framework une version prenant en charge WPF, telle que .NET Framework 4.
Dans la liste des modèles, sélectionnez Bibliothèque de contrôles utilisateur WPF.
Dans la zone Nom, tapez un nom unique pour le projet indiquant le but du contrôle.
Dans la zone de texte Emplacement, spécifiez un emplacement pour enregistrer votre projet.

Cliquez sur OK.

Le Concepteur WPF pour Visual Studio s'ouvre, affichant le 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.

Notes

Pour afficher votre contrôle utilisateur dans la Boîte à outils, activez le paramètre Remplir automatiquement les éléments de la boîte à outils. Pour plus d'informations, consultez Mise en forme, XAML, Éditeur de texte, boîte de dialogue Options.