Viadeo Twitter Google Bookmarks ! Facebook Digg del.icio.us MySpace Yahoo MyWeb Blinklist Netvouz Reddit Simpy StumbleUpon Bookmarks Windows Live Favorites 
Logo Documentation Qt ·  Page d'accueil  ·  Toutes les classes  ·  Toutes les fonctions  ·  Vues d'ensemble  · 

Address Book 5 - Adding a Find Function

Files:

In this chapter, we look at ways to locate contacts and addresses in the address book application.

As we keep adding contacts to our address book application, it becomes tedious to navigate them with the Next and Previous buttons. In this case, a Find function would be more efficient in looking up contacts. The screenshot above shows the Find button and its position on the panel of buttons.

When the user clicks on the Find button, it is useful to display a dialog that can prompt the user for a contact's name. Qt provides QDialog, which we subclass in this chapter, to implement a FindDialog class.

Defining the FindDialog Class

In order to subclass QDialog, we first include the header for QDialog in the finddialog.h file. Also, we use forward declaration to declare QLineEdit and QPushButton since we will be using those widgets in our dialog class.

As in our AddressBook class, the FindDialog class includes the Q_OBJECT macro and its constructor is defined to accept a parent QWidget, even though the dialog will be opened as a separate window.

 #include <QDialog>

 class QLineEdit;
 class QPushButton;

 class FindDialog : public QDialog
 {
     Q_OBJECT

 public:
     FindDialog(QWidget *parent = 0);
     QString getFindText();

 public slots:
     void findClicked();

 private:
     QPushButton *findButton;
     QLineEdit *lineEdit;
     QString findText;
 };

We define a public function, getFindText(), to be used by classes that instantiate FindDialog. This function allows these classes to obtain the search string entered by the user. A public slot, findClicked(), is also defined to handle the search string when the user clicks the Find button.

Lastly, we define the private variables, findButton, lineEdit and findText, corresponding to the Find button, the line edit into which the user types the search string, and an internal string used to store the search string for later use.

Implementing the FindDialog Class

Within the constructor of FindDialog, we set up the private variables, lineEdit, findButton and findText. We use a QHBoxLayout to position the widgets.

 FindDialog::FindDialog(QWidget *parent)
     : QDialog(parent)
 {
     QLabel *findLabel = new QLabel(tr("Enter the name of a contact:"));
     lineEdit = new QLineEdit;

     findButton = new QPushButton(tr("&Find"));
     findText = "";

     QHBoxLayout *layout = new QHBoxLayout;
     layout->addWidget(findLabel);
     layout->addWidget(lineEdit);
     layout->addWidget(findButton);

     setLayout(layout);
     setWindowTitle(tr("Find a Contact"));
     connect(findButton, SIGNAL(clicked()), this, SLOT(findClicked()));
     connect(findButton, SIGNAL(clicked()), this, SLOT(accept()));
 }

We set the layout and window title, as well as connect the signals to their respective slots. Notice that findButton's clicked() signal is connected to to findClicked() and accept(). The accept() slot provided by QDialog hides the dialog and sets the result code to Accepted. We use this function to help AddressBook's findContact() function know when the FindDialog object has been closed. We will explain this logic in further detail when discussing the findContact() function.

In findClicked(), we validate lineEdit to ensure that the user did not click the Find button without entering a contact's name. Then, we set findText to the search string, extracted from lineEdit. After that, we clear the contents of lineEdit and hide the dialog.

 void FindDialog::findClicked()
 {
     QString text = lineEdit->text();

     if (text.isEmpty()) {
         QMessageBox::information(this, tr("Empty Field"),
             tr("Please enter a name."));
         return;
     } else {
         findText = text;
         lineEdit->clear();
         hide();
     }
 }

The findText variable has a public getter function, getFindText(), associated with it. Since we only ever set findText directly in both the constructor and in the findClicked() function, we do not create a setter function to accompany getFindText(). Because getFindText() is public, classes instantiating and using FindDialog can always access the search string that the user has entered and accepted.

 QString FindDialog::getFindText()
 {
     return findText;
 }

Defining the AddressBook Class

To ensure we can use FindDialog from within our AddressBook class, we include finddialog.h in the addressbook.h file.

 #include "finddialog.h"

So far, all our address book features have a QPushButton and a corresponding slot. Similarly, for the Find feature we have findButton and findContact().

The findButton is declared as a private variable and the findContact() function is declared as a public slot.

     void findContact();
     ...
     QPushButton *findButton;

Lastly, we declare the private variable, dialog, which we will use to refer to an instance of FindDialog.

     FindDialog *dialog;

Once we have instantiated a dialog, we will want to use it more than once; using a private variable allows us to refer to it from more than one place in the class.

Implementing the AddressBook Class

Within the AddressBook class's constructor, we instantiate our private objects, findButton and findDialog:

     findButton = new QPushButton(tr("&Find"));
     findButton->setEnabled(false);
     ...
     dialog = new FindDialog;

Next, we connect the findButton's clicked() signal to findContact().

     connect(findButton, SIGNAL(clicked()), this, SLOT(findContact()));

Now all that is left is the code for our findContact() function:

 void AddressBook::findContact()
 {
     dialog->show();

     if (dialog->exec() == QDialog::Accepted) {
         QString contactName = dialog->getFindText();

         if (contacts.contains(contactName)) {
             nameLine->setText(contactName);
             addressText->setText(contacts.value(contactName));
         } else {
             QMessageBox::information(this, tr("Contact Not Found"),
                 tr("Sorry, \"%1\" is not in your address book.").arg(contactName));
             return;
         }
     }

     updateInterface(NavigationMode);
 }

We start out by displaying the FindDialog instance, dialog. This is when the user enters a contact name to look up. Once the user clicks the dialog's findButton, the dialog is hidden and the result code is set to QDialog::Accepted. This ensures that our if statement is always true.

We then proceed to extract the search string, which in this case is contactName, using FindDialog's getFindText() function. If the contact exists in our address book, we display it immediately. Otherwise, we display the QMessageBox shown below to indicate that their search failed.

[Previous: Address Book 4 - Editing and Removing Addresses] [Contents] [Next: Chapter 6]

Publicité

Best Of

Actualités les plus lues

Semaine
Mois
Année
  1. «Le projet de loi des droits du développeur» : quelles conditions doivent remplir les entreprises pour que le développeur puisse réussir ? 69
  2. Les développeurs détestent-ils les antivirus ? Un programmeur manifeste sa haine envers ces solutions de sécurité 27
  3. Une nouvelle ère d'IHM 3D pour les automobiles, un concept proposé par Digia et implémenté avec Qt 3
  4. Qt Creator 2.5 est sorti en beta, l'EDI supporte maintenant plus de fonctionnalités de C++11 2
  5. Vingt sociétés montrent leurs décodeurs basés sur Qt au IPTV World Forum, en en exploitant diverses facettes (déclaratif, Web, widgets) 0
  6. PySide devient un add-on Qt et rejoint le Qt Project et le modèle d'open gouvernance 1
  7. Thread travailleur avec Qt en utilisant les signaux et les slots, un article de Christophe Dumez traduit par Thibaut Cuvelier 1
  1. « Quelque chose ne va vraiment pas avec les développeurs "modernes" », un développeur à "l'ancienne" critique la multiplication des bibliothèques 101
  2. Apercevoir la troisième dimension ou l'utilisation multithreadée d'OpenGL dans Qt, un article des Qt Quarterly traduit par Guillaume Belz 0
  3. Pourquoi les programmeurs sont-ils moins payés que les gestionnaires de programmes ? Manquent-ils de pouvoir de négociation ? 51
  4. «Le projet de loi des droits du développeur» : quelles conditions doivent remplir les entreprises pour que le développeur puisse réussir ? 69
  5. Les développeurs détestent-ils les antivirus ? Un programmeur manifeste sa haine envers ces solutions de sécurité 27
  6. Qt Commercial : Digia organise un webinar gratuit le 27 mars sur la conception d'interfaces utilisateur et d'applications avec le framework 0
  7. Quelles nouveautés de C++11 Visual C++ doit-il rapidement intégrer ? Donnez-nous votre avis 10
Page suivante

Le Qt Developer Network au hasard

Logo

Introduction

Le Qt Developer Network est un réseau de développeurs Qt anglophone, où ils peuvent partager leur expérience sur le framework. Lire l'article.

Communauté

Ressources

Liens utiles

Contact

  • Vous souhaitez rejoindre la rédaction ou proposer un tutoriel, une traduction, une question... ? Postez dans le forum Contribuez ou contactez-nous par MP ou par email (voir en bas de page).

Qt dans le magazine

Cette page est une traduction d'une page de la documentation de Qt, écrite par Nokia Corporation and/or its subsidiary(-ies). Les éventuels problèmes résultant d'une mauvaise traduction ne sont pas imputables à Nokia. Qt 4.6-snapshot
Copyright © 2012 Developpez LLC. Tous droits réservés Developpez LLC. Aucune reproduction, même partielle, ne peut être faite de ce site et de l'ensemble de son contenu : textes, documents et images sans l'autorisation expresse de Developpez LLC. Sinon, vous encourez selon la loi jusqu'à 3 ans de prison et jusqu'à 300 000 E de dommages et intérêts. Cette page est déposée à la SACD.
Vous avez déniché une erreur ? Un bug ? Une redirection cassée ? Ou tout autre problème, quel qu'il soit ? Ou bien vous désirez participer à ce projet de traduction ? N'hésitez pas à nous contacter ou par MP !
 
 
 
 
Partenaires

Hébergement Web