Carnet d'adresses 3 - Navigation entre les éléments

Files:

• tutorials/addressbook-fr/part3/addressbook.cpp
• tutorials/addressbook-fr/part3/addressbook.h
• tutorials/addressbook-fr/part3/main.cpp
• tutorials/addressbook-fr/part3/part3.pro

L'application "Carnet d'adresses" est maintenant à moitié terminée. Il nous faut maintenant ajouter quelques fonctions pour naviguer entre les contacts. Avant de commencer, il faut se décider sur le type de structure de données le plus approprié pour stocker les contacts.

Dans le chapitre 2, nous avons utilisé un QMap utilisant des paires clé-valeur, avec le nom du contact comme clé, et l'adresse du contact comme valeur. Cela fonctionnait bien jusqu'ici, mais pour ajouter la navigation entre les entrées, quelques améliorations sont nécessaires.

Nous améliorerons le QMap en le faisant ressembler à une structure de données similaire à une liste liée, où tous les éléments sont connectés, y compris le premier et le dernier élément. La figure ci-dessous illustre cette structure de donnée.

Définition de la classe AddressBook

Pour ajouter les fonctions de navigation au carnet d'adresses, nous avons besoin de deux slots supplémentaires dans notre classe AddressBook: next() et previous(). Ceux-ci sont ajoutés au fichier addressbook.h:

     void next();
     void previous();

Nous avons aussi besoin de deux nouveaux objets QPushButton, nous ajoutons donc les variables privées nextButton et previousButton.

     QPushButton *nextButton;
     QPushButton *previousButton;

Implémentation de la classe AddressBook

A l'intérieur du constructeur de AddressBook, dans addressbook.cpp, nous instancions nextButton et previousButton et nous les désactivons par défaut. Nous faisons ceci car la navigation ne doit être activée que lorsqu'il y a plus d'un contact dans le carnet d'adresses.

     nextButton = new QPushButton(tr("&Next"));
     nextButton->setEnabled(false);
     previousButton = new QPushButton(tr("&Previous"));
     previousButton->setEnabled(false);

Nous connectons alors ces boutons à leur slots respectifs:

     connect(nextButton, SIGNAL(clicked()), this, SLOT(next()));
     connect(previousButton, SIGNAL(clicked()), this, SLOT(previous()));

L'image ci-dessous montre l'interface utilisateur que nous allons créer. Remarquez que cela ressemble de plus en plus à l'interface du programme complet.

Nous suivons les conventions pour les fonctions next() et previous() en plaçant nextButton à droite et previousButton à gauche. Pour faire cette mise en page intuitive, nous utilisons un QHBoxLayout pour placer les widgets côte à côte:

     QHBoxLayout *buttonLayout2 = new QHBoxLayout;
     buttonLayout2->addWidget(previousButton);
     buttonLayout2->addWidget(nextButton);

L'objet QHBoxLayout, buttonLayout2, est ensuite ajouté à mainLayout.

     mainLayout->addLayout(buttonLayout2, 2, 1);

La figure ci-dessous montre les systèmes de coordonnées pour les widgets du mainLayout.

Dans notre méthode addContact(), nous avons desactivé ces boutons pour être sûr que l'utilisateur n'utilise pas la navigation lors de l'ajout d'un contact.

     nextButton->setEnabled(false);
     previousButton->setEnabled(false);

Dans notre méthode submitContact(), nous activons les boutons de navigation, nextButton et previousButton, en fonction de la taille de contacts. Commen mentionné plus tôt, la navigation n'est activée que si il y a plus d'un contact dans le carnet d'adresses. Les lignes suivantes montrent comment faire cela:

     int number = contacts.size();
     nextButton->setEnabled(number > 1);
     previousButton->setEnabled(number > 1);

Nous incluons aussi ces lignes de code dans le bouton cancel().

Souvenez vous que nous voulons émuler une liste-liée ciruculaire à l'aide de l'objet QMap, contacts. Pour faire cela, nous obtenons un itérateur sur contact dans la méthode next(), et ensuite:

• Si l'itérateur n'est pas à la fin de contacts, nous l'incrémentons
• Si l'itérateur est à la fin de contacts, nous changeons sa position jusqu'au début de contacts. Cela donne l'illusion que notre QMap fonctionne comme une liste circulaire.

 void AddressBook::next()
 {
     QString name = nameLine->text();
     QMap<QString, QString>::iterator i = contacts.find(name);

     if (i != contacts.end())
         i++;

     if (i == contacts.end())
         i = contacts.begin();

     nameLine->setText(i.key());
     addressText->setText(i.value());
 }

Une fois que nous avons itéré jusqu'à l'objet recherché dans contacts, nous affichons son contenu sur nameLine et addressText.

De la même façon, pour la méthode previous(), nous obtenons un itérateur sur contacts et ensuite:

• Si l'itérateur est à la fin de contacts, on réinitialise l'affichage et on retourne.
• Si l'itérateur est au début de contacts, on change sa position jusqu'à la fin
• Ensuite, on décrémente l'itérateur

 void AddressBook::previous()
 {
     QString name = nameLine->text();
     QMap<QString, QString>::iterator i = contacts.find(name);

     if (i == contacts.end()){
         nameLine->clear();
         addressText->clear();
         return;
     }

     if (i == contacts.begin())
         i = contacts.end();

     i--;
     nameLine->setText(i.key());
     addressText->setText(i.value());
 }

à nouveau, nous affichons le contenu de l'objet courant dans contacts.