Carnet d'Adresses 4 - éditer et supprimer des adresses

Implémentation de la classe AddressBook

Il nous faut maintenant implémenter les fonctionnalités de changement de mode de l'application carnet d'adresses. Les boutons editButton et removeButton sont instanciés et désactivés par défaut, puisque le carnet d'adresses démarre sans aucun contact en mémoire.

     editButton = new QPushButton(tr("&Edit"));
     editButton->setEnabled(false);
     removeButton = new QPushButton(tr("&Remove"));
     removeButton->setEnabled(false);

Ces boutons sont ensuite connectés à leurs slots respectifs, editContact() et removeContact(), avant d'être ajoutés à buttonLayout1.

     connect(editButton, SIGNAL(clicked()), this, SLOT(editContact()));
     connect(removeButton, SIGNAL(clicked()), this, SLOT(removeContact()));
     ...
     buttonLayout1->addWidget(editButton);
     buttonLayout1->addWidget(removeButton);

La methode editContact() place les anciens détails du contact dans oldName et oldAddress, avant de basculer vers le mode EditingMode. Dans ce mode, les boutons submitButton et cancelButton sont tous deux activés, l'utilisateur peut par conséquent modifier les détails du contact et cliquer sur l'un de ces deux boutons par la suite.

 void AddressBook::editContact()
 {
     oldName = nameLine->text();
     oldAddress = addressText->toPlainText();

     updateInterface(EditingMode);
 }

La méthode submitContact() a été divisée en deux avec un bloc if-else. On teste currentMode pour voir si le mode courant est AddingMode. Si c'est le cas, on procède à l'ajout.

 void AddressBook::submitContact()
 {
     ...
     if (currentMode == AddingMode) {

         if (!contacts.contains(name)) {
             contacts.insert(name, address);
             QMessageBox::information(this, tr("Add Successful"),
                 tr("\"%1\" has been added to your address book.").arg(name));
         } else {
             QMessageBox::information(this, tr("Add Unsuccessful"),
                 tr("Sorry, \"%1\" is already in your address book.").arg(name));
         }

Sinon, on s'assure que currentMode est en EditingMode. Si c'est le cas, on compare oldName et name. Si le nom a changé, on supprime l'ancien contact de contacts et on insère le contact mis a jour.

     } else if (currentMode == EditingMode) {

         if (oldName != name) {
             if (!contacts.contains(name)) {
                 QMessageBox::information(this, tr("Edit Successful"),
                     tr("\"%1\" has been edited in your address book.").arg(oldName));
                 contacts.remove(oldName);
                 contacts.insert(name, address);
             } else {
                 QMessageBox::information(this, tr("Edit Unsuccessful"),
                     tr("Sorry, \"%1\" is already in your address book.").arg(name));
             }
         } else if (oldAddress != address) {
             QMessageBox::information(this, tr("Edit Successful"),
                 tr("\"%1\" has been edited in your address book.").arg(name));
             contacts[name] = address;
         }
     }

     updateInterface(NavigationMode);
 }

Si seule l'adresse a changé (i.e. oldAddress n'est pas identique à address), on met à jour l'adresse du contact. Enfin on règle currentMode à NavigationMode. C'est une étape importante puisque c'est cela qui réactive tous les boutons désactivés.

Afin de retirer un contact du carnet d'adresses, on implémente la méthode removeContact(). Cette méthode vérifie que le contact est présent dans contacts.

 void AddressBook::removeContact()
 {
     QString name = nameLine->text();
     QString address = addressText->toPlainText();

     if (contacts.contains(name)) {

         int button = QMessageBox::question(this,
             tr("Confirm Remove"),
             tr("Are you sure you want to remove \"%1\"?").arg(name),
             QMessageBox::Yes | QMessageBox::No);

         if (button == QMessageBox::Yes) {

             previous();
             contacts.remove(name);

             QMessageBox::information(this, tr("Remove Successful"),
                 tr("\"%1\" has been removed from your address book.").arg(name));
         }
     }

     updateInterface(NavigationMode);
 }

Si c'est le cas, on affiche une boîte de dialogue QMessageBox, demandant confirmation de la suppression à l'utilisateur. Une fois la confirmation effectuée, on appelle previous(), afin de s'assurer que l'interface utilisateur affiche une autre entrée, et on supprime le contact en utilisant le méthode remove() de QMap. Dans un souci pratique, on informe l'utilisateur de la suppression par le biais d'une autre QMessageBox. Les deux boîtes de dialogue utilisées dans cette méthode sont représentées ci-dessous.

Mise à jour de l'Interface utilisateur

On a évoqué plus haut la méthode updateInterface() comme moyen d'activer et de désactiver les différents boutons de l'interface en fonction du mode. Cette méthode met à jour le mode courant selon l'argument mode qui lui est passé, en l'assignant à currentMode, avant de tester sa valeur.

Chacun des boutons est ensuite activé ou désactivé, en fonction du mode. Le code source pour les cas AddingMode et EditingMode est visible ci-dessous:

 void AddressBook::updateInterface(Mode mode)
 {
     currentMode = mode;

     switch (currentMode) {

     case AddingMode:
     case EditingMode:

         nameLine->setReadOnly(false);
         nameLine->setFocus(Qt::OtherFocusReason);
         addressText->setReadOnly(false);

         addButton->setEnabled(false);
         editButton->setEnabled(false);
         removeButton->setEnabled(false);

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

         submitButton->show();
         cancelButton->show();
         break;

Dans le cas de NavigationMode, en revanche, des tests conditionnels sont passés en paramètre de QPushButton::setEnabled(). Ceci permet de s'assurer que les boutons editButton et removeButton ne sont activés que s'il existe au moins un contact dans le carnet d'adresses; nextButton et previousButton ne sont activés que lorsqu'il existe plus d'un contact dans le carnet d'adresses.

     case NavigationMode:

         if (contacts.isEmpty()) {
             nameLine->clear();
             addressText->clear();
         }

         nameLine->setReadOnly(true);
         addressText->setReadOnly(true);
         addButton->setEnabled(true);

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

         submitButton->hide();
         cancelButton->hide();
         break;
     }
 }

En effectuant les opérations de réglage du mode et de mise à jour de l'interface utilisateur au sein de la même méthode, on est à l'abri de l'éventualité où l'interface utilisateur se "désynchronise" de l'état interne de l'application.

Files:

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