Partager via

Étape 9 : examiner, commenter et tester votre code

  • Article

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 est composée d'instructions.En d'autres termes, une méthode permet de regrouper des instructions.

  • 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 Tutorial 1: Create a Picture Viewer in Visual Basic - Video 5 ou Tutorial 1: Create a Picture Viewer in C# - Video 5.

Ensuite, ajoutez un commentaire à votre code.Un commentaire est une annotation qui ne modifie pas le comportement du programme.Il permet à une autre personne de mieux comprendre les actions de votre code.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.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.

Pour ajouter des commentaires

  1. Ajoutez le code suivant.

    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 clique sur le bouton OK, de charger ce fichier dans le PictureBox.

    [!REMARQUE]

    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 accéder à tous ces extraits en sélectionnant Gestionnaire des extraits de code dans le menu Outils.L'extrait if est disponible dans Modèles de code, à l'intérieur du sous-dossier Conditions et boucles.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 sont affichés dans la fenêtre IntelliSense : vous devez donc appuyer deux fois sur TAB pour, d'abord sélectionner l'extrait dans la fenêtre IntelliSense, et ensuite 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 cliquant sur le bouton Enregistrer tout de la barre d'outils, qui apparaît comme suit.

    Bouton Enregistrer tout

    Bouton de barre d'outils Enregistrer tout

    Pour enregistrer votre programme, vous pouvez aussi cliquer sur Enregistrer tout dans le menu Fichier.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 cliquez sur le bouton Démarrer le débogage de la barre d'outils.

  2. Cliquez sur 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.

  3. Chargez une image et elle s'affiche dans votre PictureBox.Essayez ensuite de redimensionner votre formulaire.É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 continuer ou examiner