Procédure pas à pas : création de contrôles utilisateur pour les appareils de type Smart Device

Article
08/21/2008

Mise à jour : novembre 2007

Dans cette procédure pas à pas, vous créez une bibliothèque de contrôles et développez un contrôle utilisateur à placer dans celle-ci. Faites la distinction entre un contrôle utilisateur, une combinaison de contrôles Windows Forms au sein d'une même unité réutilisable, et un contrôle personnalisé, un contrôle qui requiert une interface utilisateur ou une fonctionnalité non disponible par le biais de contrôles standard.

Le contrôle utilisateur de cette procédure pas à pas est un affichage d'horloge simple pour les appareils. Il est basé sur des procédures pas à pas de bureau, telles que Procédure pas à pas : création d'un contrôle composite à l'aide de Visual Basic et Procédure pas à pas : création d'un contrôle composite à l'aide de Visual C#.

La procédure pas à pas se compose de quatre tâches principales :

Création d'une bibliothèque de contrôles et d'un contrôle.
Affectation d'un nouveau nom à la bibliothèque et au contrôle.
Ajout de composants au contrôle.
Test du contrôle de Microsoft Device Emulator.

Vous pouvez utiliser Visual Basic ou Visual C# pour cette procédure pas à pas. Lorsque les deux langages utilisent le même nom de fichier, mais avec une extension spécifique au langage, une barre verticale vous demande de choisir l'extension employée par le langage utilisé, comme dans NomFichier.vb|cs.

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 Basic et des Paramètres de développement Visual C#.

Composants requis

Aucun.

Choix d'un appareil cible

La procédure suivante permet d'afficher un message vous invitant à sélectionner un appareil lorsque vous déployez une solution.

Pour être invité à sélectionner l'appareil cible au moment du déploiement

Dans le menu Outils, cliquez sur Options, développez Outils d'appareils, puis cliquez sur Général.

(Si vous ne voyez pas Outils d'appareils, sélectionnez Afficher tous les paramètres en bas de la boîte de dialogue Options.)
Activez la case à cocher Afficher les choix d'appareils avant de déployer un projet Smart Device.

Création du projet

Le nom que vous donnez à un nouveau projet définit également l'espace de noms racine et le nom de l'assembly.

Pour créer la bibliothèque de contrôles et le contrôle

(Visual Basic) Dans le menu Fichier, cliquez sur Nouveau projet.

- ou -

(Visual C#) Dans le menu Fichier, pointez sur Nouveau, puis cliquez sur Projet.
Dans le volet Type de projets de la boîte de dialogue Nouveau projet , développez Visual Basic ou Visual C#, puis cliquez sur Smart Device.

Si le langage voulu n'apparaît pas directement, développez Autres langages. Cet affichage est régi par vos paramètres de développement.
Dans le volet Modèles, cliquez sur Projet Smart Device.
Dans la zone Nom, tapez ctlDevClockLib, puis cliquez sur OK.
(Visual C# uniquement) Dans la zone Emplacement, vérifiez l'emplacement où vous souhaitez stocker vos fichiers projet, puis cliquez sur OK.
Dans le menu déroulant Plateforme cible, sélectionnez Pocket PC 2003.
Sélectionnez .NET Compact Framework version 2.0 dans le menu déroulant Version du .Net Compact Framework.
Cliquez sur Bibliothèque de contrôles dans le volet Modèles, puis cliquez sur OK.

Le Concepteur de composants s'affiche.

Vous avez déjà spécifié le nom du projet, l'espace de noms racine et le nom de l'assembly (ctlDevClockLib). Toutefois, les composants dans le projet ont des noms par défaut assignés par Visual Studio (par exemple, UserControl1). Vous souhaitez en général remplacer ces noms par des termes plus explicites.

Pour renommer la bibliothèque et le contrôle

Dans l'Explorateur de solutions, cliquez avec le bouton droit sur UserControl1.vb|cs, puis cliquez sur Propriétés.
Remplacez le Nom de fichier par ctlDevClock.vb|cs.
(Visual C# uniquement) Dans le message demandant si vous souhaitez toutes les références à cet élément de code renommé, cliquez sur Oui.

La modification de nom dans la fenêtre Propriétés se propage à présent vers d'autres références, telles que le nom et le constructeur de classe.

Vous ajoutez ensuite des composants de la Boîte à outils pour fournir des fonctionnalités et une interaction utilisateur pour votre contrôle utilisateur. Dans cette procédure pas à pas, vous ajoutez un contrôle Timer pour accéder à l'heure système et un contrôle Label pour afficher l'heure.

Pour ajouter des composants et modifier leurs propriétés

Dans la Boîte à outils, double-cliquez sur Label.

Un contrôle Label est ajouté au contrôle utilisateur dans le Concepteur de composants.
Dans la fenêtre Propriétés du contrôle d'étiquette, procédez comme suit :

Propriété	Remplacez par
Nom	lblDisplay
Text	(vide)
TextAlign	TopCenter
Font.Size	14

Dans la Boîte à outils, double-cliquez sur Timer.

Un contrôle Timer apparaît dans la barre d'état des composants.
Dans la fenêtre Propriétés du contrôle Timer, procédez comme suit :

Propriété	Remplacez par
Interval	1000
Enabled	True

Dans les étapes suivantes, vous ajoutez un gestionnaire d'événements pour afficher des battements d'horloge dans le contrôle Label.

Pour ajouter un gestionnaire d'événements

Dans la barre d'état des composants, double-cliquez sur Timer1 (Visual Basic) ou timer1 (C#) pour ouvrir l'éditeur de code au niveau de l'événement Tick.

(Visual Basic) Insérez ce code de gestion des événements :

lblDisplay.Text = Format(Now, "hh:mm:ss")

- ou -

(Visual C#)

lblDisplay.Text = DateTime.Now.ToLongTimeString();

(Visual Basic) Remplacez le modificateur d'accès Private par Protected et ajoutez le mot clé Overridable afin que le code du gestionnaire ressemble au code suivant :

Protected Overridable Sub Timer1_Tick(ByVal sender As Object, _
   ByVal e As System.EventArgs) Handles Timer1.Tick
   ' Causes the label to display the current time  
   lblDisplay.Text = Format(Now, "hh:mm:ss")
End Sub

- ou -

(Visual C#) Remplacez le modificateur d'accès private par protected et ajoutez le mot clé virtual afin que le code du gestionnaire ressemble au code suivant :

protected virtual void timer1_Tick(object sender, System.EventArgs
   e)
{
   // Causes the label to display the current time.
   lblDisplay.Text = DateTime.Now.ToLongTimeString(); 
}

Dans le menu Fichier, cliquez sur Enregistrer tout.
(Visual Basic uniquement) Dans la boîte de dialogue Enregistrer un projet, enregistrez le projet en tant que ctlDevClockLib à un emplacement de votre choix.

Test du contrôle

Cette application Smart Device simple sert de conteneur de test pour votre contrôle.

Pour générer le contrôle et créer un conteneur de test

Dans le menu Générer, cliquez sur Générer (ou sur Générer ctlDevClockLib).
Dans le menu Fichier, pointez sur Ajouter, puis cliquez sur Nouveau projet.
Dans la boîte de dialogue Ajouter un nouveau projet, cliquez sur Smart Device dans le volet Types de projets, puis cliquez sur Projet Smart Device dans le volet Modèles.
Dans la zone Nom, tapez Test, puis cliquez sur OK.
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 Application Smart Device dans le volet Modèles, puis cliquez sur OK.
Dans l'Explorateur de solutions, cliquez avec le bouton droit sur le projet Test, puis cliquez sur Définir comme projet de démarrage.
Cliquez avec le bouton droit sur le projet Test, puis cliquez sur Ajouter une référence.
Dans la boîte de dialogue Ajouter une référence, cliquez sur l'onglet Projets, puis double-cliquez sur ctlDevClockLib.
Dans la Boîte à outils, localisez l'onglet Composants ctlDevClockLib, puis double-cliquez sur le composant ctlDevClock.

Le contrôle est chargé dans le concepteur.
Dans le menu Déboguer, cliquez Démarrer (ou Démarrer le débogage).
Dans la boîte de dialogue Déployer, sélectionnez Pocket PC 2003 SE - émulateur, puis cliquez sur Déployer.