Qt Reference Documentation

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

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

Dans ce chapitre, nous verrons comment modifier les données des contacts contenus dans l'application carnet d'adresses.

Nous avons maintenant un carnet d'adresses qui ne se contente pas de lister des contacts de façon ordonnée, mais permet également la navigation. Il serait pratique d'inclure des fonctions telles qu'éditer et supprimer, afin que les détails associés à un contact puissent être modifiés lorsque c'est nécessaire. Cependant, cela requiert une légère modification, sous la forme d'énumérations. Au chapitre précédent, nous avions deux modes: `AddingMode` et `NavigationMode`, mais ils n'étaient pas définis en tant qu'énumérations. Au lieu de ça, on activait et désactivait les boutons correspondants manuellement, au prix de multiples redondances dans le code.

Dans ce chapitre, on définit l'énumération `Mode` avec trois valeurs possibles.

- `NavigationMode`,
- `AddingMode`, et
- `EditingMode`.

## Définition de la classe AddressBook

Le fichier `addressbook.h` est mis a jour pour contenir l'énumération `Mode` :

         enum Mode { NavigationMode, AddingMode, EditingMode };

On ajoute également deux nouveaux slots, `editContact()` et `removeContact()`, à notre liste de slots publics.

         void editContact();
         void removeContact();

Afin de basculer d'un mode à l'autre, on introduit la méthode `updateInterface()` pour contrôller l'activation et la désactivation de tous les objets QPushButton. On ajoute également deux nouveaux boutons, `editButton` et `removeButton`, pour les fonctions d'édition et de suppression mentionnées plus haut.

         void updateInterface(Mode mode);
         ...
         QPushButton *editButton;
         QPushButton *removeButton;
         ...
         Mode currentMode;

Enfin, on déclare `currentMode` pour garder une trace du mode actuellement utilisé.

## 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.