CodePPC - Programmez votre Pocket PC

Nous allons passer en revue le fonctionnement des contrôles les plus utilisés dans une application eVB. Ceci est un résumé des propriétés, méthodes, et événements les plus souvent mis en oeuvre. Je vous conseille dans un premier temps d'aller vous même tester les effets des propriétés de ces contrôles.

Un contrôle est un objet, le plus souvent visuel, qui simplifie énormément le développement d'applications. Windows CE met à la disposition des développeurs toute une serie d'outils visuels qui vont du simple bouton de commande, en passant par les listes, avec au passage un brin de web browser. En gros, avec Windows CE vous n'inventez pas sans arrêt la roue (comme avec le Windows de votre PC de bureau d'ailleurs).

Donc, eVB vous permet d'utiliser en standard une partie des contrôles fournis par Windows CE.

Quasiment tous les contrôles visuels possèdent une propriété Visible (True = visible, False = invisible), et Enabled (True = actif, False = inactif).

La propriété Tag permet de placer une valeur quelconque, de votre choix liée au contrôle. A vous de l'utiliser comme une propriété personnalisée.

Certain contrôles permettent la modification de leur couleur de fond avec la propriété BackColor, et la couleur du texte (quand il y en a) avec la propriété ForeColor.

Le contrôle CommandButton permet de placer un bouton de commande sur la fenêtre.

Vous pouvez modifier le titre du bouton. Pour cela, vous devez utiliser la propriété Caption, soit directement depuis la fenêtre des propriété du bouton, soit directement dans le code par l'affectation d'une chaine de caractères :

Lorsque l'utilisateur clique sur le bouton, un événement Click est généré, ce qui vous permet de réagir à cette action :

Sub MonBouton_Click()
   Msgbox "Bonjour le monde !"
 End Sub

Vous pouvez rendre le bouton inactif en plaçant False dans la propriété Enabled.

Le contrôle 'TextBox'

Le contrôle TextBox permet la saisie de texte sans aucune programmation. Comme le contrôle Commandbutton, Le TextBox possède les propriétés Left, Top, Width et Height qui permettent de le placer sur la fenêtre par programme.

Le texte saisi par l'utilisateur est accessible depuis la propriété Text. Vous pouvez placer du texte dans le contrôle en affectant une chaine de caractères à cette même propriété. On dit que c'est une propriété en lecture/écriture :

MonTexte.Text = "Bonjour tout le monde !"

Vous pouvez limiter le nombre de caractères autorisés en utilisant la propriété MaxLength. Si vous placez une valeur >0, le TextBox n'acceptera au maximum que ce nombre de caractères. La valeur zéro indique qu'il n'y a pas de limitation.

Vous pouvez aussi stipuler que les caractères tapés ne doivent pas être affichés mais remplacés (juste à l'affichage, pas dans la propriété Text) par un caractère spécial. C'est la propriété PasswordChar qui permet ceci. Ceci permet de créer une zone de saisie de mot de passe par exemple.

Il est possible de contrôler complètement ce que tape l'utilisateur en utilisant l'événement KeyPress. Vous trouverez un article complet sur la manière d'y arriver ici.

Si vous avez besoin de saisir du texte sur plusieurs lignes, vous pouvez le stipuler en plaçant la valeur True (Vrai) dans la propriété Multiline et en retaillant votre TextBox (augmentation de sa hauteur). Si vous voulez que des barres de scroll apparaissent, il vous suffit de placer dans la propriété ScrollBars la valeur 1 pour une barre horizontale, 2 pour une barre verticale et 3 pour les deux (zéro = pas de barre de scroll).

Le contrôle 'ListBox'

Le contrôle ListBox permet de gérer très simplement des listes. Une liste est composée d'un ensemble de lignes de texte qui sont des Items. Il est possible de sélectionner un item avec le stylet et une barre de scroll verticale est automatiquement affichée si le nombre d'items est trop grand pour entrer dans la hauteur de la liste.

Pour ajouter un item dans la liste, il faut utiliser la méthode AddItem avec en paramètre la chaine de caractères à ajouter :

Call MaListe.AddItem("Mon item 1")
Call MaListe.AddItem("Mon item 2")

La propriété ListIndex retourne l'item sélectionné. La valeur -1 indique qu'aucun item est sélectionné. Le premier item a le n° zéro. Lorsque l'utilisateur sélectionne un item, l'événement Click est déclenché.

Si vous voulez accéder ou modifier un item présent dans la liste, vous devez utiliser la propriété List avec le n° de l'item souhaité en indice :

Item3 = MaListe.List(2)
MaListe.List(0)="Premier item"

La propriété ListCount retourne le nombre d'items dans la liste. Attention donc, si vous voulez parcourir la liste, il faut partir de zéro à ListCount-1 !

Vous pouvez utiliser une liste triée en plaçant True dans la propriété Sorted.

Pour vider toute la liste, vous devez utiliser la méthode Clear.

Pour éliminer un item, vous devez utiliser la méthode RemoveItem avec comme paramètre le n° de l'item à détruire :

Call MaListe.RemoveItem(3)

Le contrôle 'Label'

Le contrôle Label permet d'afficher un texte à l'écran. C'est le contrôle le plus simple à utiliser.

La propriété Caption permet de placer le texte à afficher. Comme pour les autres contrôles, les propriétés Top, Left, Width et Height sont présentent avec aussi Enabled. Le contrôle Label réagit à l'événement Click et peut être rendu invisible en plaçant la valeur False dans la propriété Visible et biensûr inactif en utilisant sa propriété Enabled.

Le contrôle 'Timer'

Le contrôle Timer n'est pas vraiment un contrôle Visuel car lors de l'exécution il est invisible. Ce contrôle permet d'effectuer une tâche à intervale régulier.

Pour cela, vous disposez de la propriété Interval qui détermine le temps qui doit s'écouler entre 2 appels. La valeur doit être indiquée en 1000ème de seconde, ainsi 1000 correspond à 1 seconde.

La propriété Enabled permet de mettre en route (True) ou de suspendre (False) le timer.

Lorsque le timer se déclenche, il génère un événement Timer. Tant que le code placé dans cet événement n'est pas terminé, le timer est suspendu. Donc, si vous définissez un intervale de 2 secondes (Interval=2000), le Timer se déclenchera au mieux toute les 2 secondes plus le temps de traitement du code déclenché par l'événement Timer.