Partager via

Étape 9 : examiner, commenter et tester votre code

  • Article

Ensuite, ajoutez un commentaire à votre code.Un commentaire est une annotation qui ne modifie pas le comportement du programme.Il permet à une autre personne qui lit votre code de mieux le comprendre.L'ajout de commentaires à votre code est une bonne habitude à prendre.Une ligne de commentaire est indiquée par deux barres obliques (//) en Visual C#et par un guillemet simple (') en Visual Basic.Après avoir ajouté un commentaire, testez votre programme.Quand vous travaillez sur vos projets, il est recommandé d'exécuter et de tester souvent le code afin que vous puissiez détecter et résoudre les problèmes au plus tôt, avant que le code devienne plus complexe.Cette opération est appelée test itératif.

Vous venez de générer un programme qui fonctionne, et bien qu'il ne soit pas encore terminé, il peut déjà charger une image.Avant d'ajouter un commentaire à votre code et de le tester, prenez le temps de revoir les concepts de code, car vous serez amené à les utiliser régulièrement :

  • Lorsque vous avez double-cliqué sur le bouton Afficher une image dans le Concepteur Windows Forms, l'IDE a ajouté automatiquement une méthode au code de votre programme.

  • Les méthodes vous permettent d'organiser votre code : c'est ainsi que votre code est regroupé.

  • La plupart du temps, une méthode effectue un petit nombre d'actions dans un ordre spécifique, (comme lorsque votre méthode showButton_Click() affiche une boîte de dialogue, puis charge une image).

  • Une méthode se compose d'instructions ou de lignes de code.En d'autres termes, une méthode permet de regrouper des instructions de code.

  • Lorsqu'une méthode est exécutée (ou appelée), les instructions qu'elle contient sont exécutées dans l'ordre, l'une après l'autre, en commençant par la première.

    Voici un exemple d'instruction.

    pictureBox1.Load(openFileDialog1.FileName);

    pictureBox1.Load(openFileDialog1.FileName)

    Les instructions permettent à vos programmes d'effectuer des actions.En Visual C#, une instruction se termine toujours par un point-virgule.En Visual Basic, la fin d'une ligne indique la fin d'une instruction. (Aucun point-virgule n'est nécessaire en Visual Basic.) L'instruction précédente indique à votre contrôle PictureBox de charger le fichier que l'utilisateur a sélectionné avec le composant OpenFileDialog.

lien vers la vidéoPour obtenir une version vidéo de cette rubrique, consultez Didacticiel 1 : Créer une visionneuse d'images en Visual Basic – Vidéo 5 ou Didacticiel 1 : Créer une visionneuse d'images en C# – Vidéo 5.Ces vidéos utilisent une version antérieure de Visual Studio et présentent donc de légères différences quant à certaines commandes de menu et autres éléments d'interface utilisateur.Toutefois, les concepts et les procédures fonctionnent de façon similaire dans la version actuelle de Visual Studio.

Pour ajouter des commentaires

  1. Ajoutez le commentaire suivant à votre code.

    Private Sub showButton_Click() Handles showButton.Click

    ' Show the Open File dialog. If the user clicks OK, load the 
    ' picture that the user chose. 
    If OpenFileDialog1.ShowDialog() = DialogResult.OK Then
        PictureBox1.Load(OpenFileDialog1.FileName)
    End If 

End Sub

    private void showButton_Click(object sender, EventArgs e)
{
    // Show the Open File dialog. If the user clicks OK, load the 
    // picture that the user chose. 
    if (openFileDialog1.ShowDialog() == DialogResult.OK)
    {
        pictureBox1.Load(openFileDialog1.FileName);
    }
}

    [!REMARQUE]

    Le gestionnaire d'événements Click de votre bouton showButton est maintenant terminé, et il fonctionne.Vous avez commencé votre code par une instruction if.Une instruction if vous permet de dire à votre programme : « Vérifie ceci, et si c'est vrai (true), fais cela ». Ici, vous demandez à votre programme d'ouvrir la boîte de dialogue Ouvrir un fichier, et si l'utilisateur sélectionne un fichier et choisit le bouton OK, de charger ce fichier dans le contrôle PictureBox.

    ConseilConseil

    L'IDE est conçu pour vous aider à écrire votre code facilement, notamment grâce aux extraits de code.Un extrait est un raccourci qui se développe en petit bloc de code.

    Vous pouvez consulter tous les extraits de code disponibles.Dans la barre de menus, choisissez Outils, Gestionnaire des extraits de code.Pour Visual C#, l'extrait de code if se trouve dans Visual C#.Pour Visual Basic, les extraits de code if se trouvent dans Conditions et boucles, Modèles de code.Vous pouvez utiliser ce gestionnaire pour parcourir les extraits existants ou ajouter les vôtres.

    Pour activer un extrait lorsque vous écrivez du code, tapez-le et appuyez sur la touche Tab.De nombreux extraits étant affichés dans la fenêtre IntelliSense, vous devez appuyer deux fois sur la touche Tab : pour sélectionner l'extrait dans la fenêtre IntelliSense, puis pour demander à l'IDE de l'utiliser. (IntelliSense prend en charge l'extrait if, mais pas ifelse.)

  2. Avant d'exécuter votre programme, enregistrez-le en choisissant le bouton Enregistrer tout (qui se présente comme ci-dessous) dans la barre d'outils.

    Bouton Enregistrer tout

    Bouton de barre d'outils Enregistrer tout

    Vous pouvez également enregistrer votre programme en choisissant Fichier, Enregistrer tout dans la barre de menus.Il est conseillé d'enregistrer votre travail régulièrement.

    Lorsqu'il est exécuté, votre programme doit ressembler à l'image suivante.

    Visionneuse d'images

    Visionneuse d'images

Pour tester votre programme

  1. Appuyez sur la touche F5 ou choisissez le bouton Démarrer le débogage de la barre d'outils.

  2. Choisissez le bouton Afficher une image pour exécuter le code que vous venez d'écrire.En premier lieu, le programme ouvre une boîte de dialogue Ouvrir un fichier.Vérifiez que vos filtres s'affichent dans la liste déroulante Types de fichiers en bas de la boîte de dialogue.Ensuite, naviguez jusqu'à une image et ouvrez-la.En général, des échantillons d'images sont fournis avec le système d'exploitation Windows, dans votre dossier Mes documents, à l'intérieur du dossier Mes images\Échantillons d'images.

    [!REMARQUE]

    Si aucune image ne s'affiche dans la boîte de dialogue Sélectionner un fichier image, vérifiez que le filtre « Tous les fichiers (*.*) » est sélectionné dans la liste déroulante figurant en bas à droite de la boîte de dialogue.

  3. Chargez une image et elle s'affiche dans votre PictureBox.Essayez ensuite de redimensionner votre formulaire en faisant glisser ses bordures.Étant donné que votre PictureBox est ancré à l'intérieur d'un TableLayoutPanel (lui-même ancré à l'intérieur du formulaire), votre zone d'image se redimensionnera automatiquement à la même largeur que le formulaire, et remplira les 90 pour cent supérieurs du formulaire.C'est la raison pour laquelle vous avez utilisé les conteneurs TableLayoutPanel et FlowLayoutPanel : ils permettent à votre formulaire de converser des dimensions correctes lorsque l'utilisateur le redimensionne.

    Pour le moment, les images de grande taille dépassent les bordures de votre visionneuse d'images.Dans l'étape suivante, vous ajouterez du code pour ajuster les images dans la fenêtre.

Pour continuer ou examiner