Procédure pas à pas : ajout d'un attribut simple à un contrôle utilisateur

Mise à jour : novembre 2007

Cette procédure pas à pas montre comment ajouter un attribut à un contrôle utilisateur dans un projet Smart Device. Plus particulièrement, vous pouvez ajouter un attribut personnalisé qui rend une propriété du contrôle invisible au moment du design. Vous pouvez ajouter cette fonctionnalité à un projet pour empêcher la modification d'une valeur de propriété.

Le processus est semblable à celui du bureau, mais les projets Smart Device stockent ces informations dans un fichier de métadonnées séparé (.xmta).

Remarque :

Il est possible que votre ordinateur affiche des noms ou des emplacements différents pour certains des éléments d'interface utilisateur Visual Studio dans les instructions suivantes. L'édition de Visual Studio dont vous disposez et les paramètres que vous utilisez déterminent ces éléments. Pour plus d'informations, consultez Paramètres Visual Studio.

Cette procédure pas à pas a été écrite à l'aide des Paramètres de développement Visual C#.

Pour créer la classe UserControl1

  1. Dans le menu Fichier, pointez sur Nouveau, puis cliquez sur Fichier.

  2. Dans le volet Types de projets, développez Visual C#, puis cliquez sur Smart Device.

  3. Dans le volet Modèles, cliquez sur Projet Smart Device.

  4. Dans la zone Nom, tapez MyControlLibrary, puis cliquez sur OK.

  5. Dans la boîte de dialogue Ajoutez un nouveau projet Smart Device, sélectionnez Pocket PC 2003 dans le menu déroulant Plateforme cible, sélectionnez .NET Compact Framework version 2.0 dans le menu déroulant Compact Framework, cliquez sur Bibliothèque de contrôles dans le volet Modèles, puis cliquez sur OK.

    Le concepteur s'affiche avec un carré qui représente la nouvelle classe de contrôle utilisateur.

Pour ajouter une propriété

  1. Dans l'Explorateur de solutions, cliquez avec le bouton droit sur UserControl1.cs, puis cliquez sur Afficher le diagramme de classes.

    Un rectangle arrondi qui représente le diagramme de classes s'affiche.

  2. Cliquez avec le bouton droit sur le diagramme de classes, puis cliquez sur Détails de classe.

  3. Dans la section Propriétés de la fenêtre Détails de classe, à l'invite <Ajouter une propriété>, tapez MyProperty.

  4. Dans la colonne Type, remplacez int par string.

  5. Cliquez avec le bouton droit sur l'icône située au début de la ligne MyProperty, puis dans le menu contextuel, cliquez sur Propriétés.

  6. Pour spécifier une valeur pour la propriété Custom Attributes, cliquez sur le bouton de sélection (...) pour afficher la boîte de dialogue Attributs personnalisés.

  7. Tapez Browsable(false), puis cliquez sur OK.

    Au moment du design, l'Explorateur de solutions affiche un fichier d'attribut .xmta (DesignTimeAttributes.xmta) qui contient l'attribut personnalisé.

Pour générer la bibliothèque de contrôles

  1. Dans l'Explorateur de solutions, cliquez avec le bouton droit sur UserControl1.cs, puis sélectionnez Afficher le code.

  2. Supprimez la ligne qui lève l'exception System.NotImplementedException et insérez return ""; à la place de l'action get.

  3. Dans le menu Générer, cliquez sur Générer MyControlLibrary.

Pour tester si MyProperty n'apparaît pas dans le navigateur de propriétés

  1. Dans l'Explorateur de solutions, cliquez avec le bouton droit sur MyControlLibrary, pointez sur Ajouter, puis sélectionnez Nouvel élément.

  2. Dans la boîte de dialogue Ajouter un nouvel élément, cliquez sur Windows Forms dans le volet Catégories, cliquez sur Windows Form dans le volet Modèles, puis cliquez sur Ajouter.

  3. À partir de la Boîte à outils, faites glisser un contrôle UserControl1 dans le formulaire.

  4. Cliquez avec le bouton droit sur l'image du contrôle utilisateur dans le formulaire, puis, dans le menu contextuel, cliquez sur Propriétés.

    MyProperty n'apparaît pas dans l'Explorateur de propriétés.

  5. Dans l'Explorateur de solutions, double-cliquez sur le fichier .xmta, puis remplacez False par True.

  6. Répétez les étapes pour afficher la grille Propriétés. Notez que MyProperty apparaît à présent.

Voir aussi

Référence

Visual Basic et Visual C# (Comment faire dans les projets Smart Device)

  • Last updated on