From f2c04aac807dcbf68c2fa46b6c8c8c3f206a6752 Mon Sep 17 00:00:00 2001
From: Kavindra Devi Palaraja <kavindra.palaraja@nokia.com>
Date: Mon, 20 Jul 2009 10:52:31 +0200
Subject: [PATCH] Doc - Fixing up Part 3 to use ui->

Reviewed-By: TrustMe

Details: Also fixed a minor bug that caused both the Submit and Cancel
buttons to not disappear after the user clicked Submit.
---
 doc/addressbook-sdk.qdoc                      |  10 +-
 .../addressbook-sdk/part3/addressbook.cpp     | 131 ++++++++----------
 .../addressbook-sdk/part3/addressbook.h       |  16 +--
 3 files changed, 60 insertions(+), 97 deletions(-)

diff --git a/doc/addressbook-sdk.qdoc b/doc/addressbook-sdk.qdoc
index f8fbc4c0fd5..0df0603af9c 100644
--- a/doc/addressbook-sdk.qdoc
+++ b/doc/addressbook-sdk.qdoc
@@ -471,13 +471,9 @@
 
     \snippet examples/addressbook-sdk/part3/addressbook.h slot definition
 
-    We also define two more QPushButton objects:
-
-    \snippet examples/addressbook-sdk/part3/addressbook.h members
-
-    In the \c AddressBook constructor, we extract the push buttons from the
-    \c ui object and disable them by default. This is because navigation is
-    only enabled when there is more than one contact in the address book.
+    In the \c AddressBook constructor, we setup our fields and disable them by
+    default. This is because navigation is only enabled when there is more than
+    one contact in the address book.
 
     \snippet examples/addressbook-sdk/part3/addressbook.cpp extract objects
 
diff --git a/doc/examples/addressbook-sdk/part3/addressbook.cpp b/doc/examples/addressbook-sdk/part3/addressbook.cpp
index 304fd5f7a2b..aac151a0835 100644
--- a/doc/examples/addressbook-sdk/part3/addressbook.cpp
+++ b/doc/examples/addressbook-sdk/part3/addressbook.cpp
@@ -6,45 +6,27 @@ AddressBook::AddressBook(QWidget *parent)
 {
     ui->setupUi(this);
 
-    nameLine = new QLineEdit;
-    nameLine = ui->nameLine;
-    nameLine->setReadOnly(true);
-
-    addressText = new QTextEdit;
-    addressText = ui->addressText;
-    addressText->setReadOnly(true);
-
-    addButton = new QPushButton;
-    addButton = ui->addButton;
-
-    submitButton = new QPushButton;
-    submitButton = ui->submitButton;
-    submitButton->hide();
-
-    cancelButton = new QPushButton;
-    cancelButton = ui->cancelButton;
-    cancelButton->hide();
-
-//! [extract objects]
-    nextButton = new QPushButton;
-    nextButton = ui->nextButton;
-    nextButton->setEnabled(false);
-
-    previousButton = new QPushButton;
-    previousButton = ui->previousButton;
-    nextButton->setEnabled(false);
-//! [extract objects]
-
-    connect(addButton, SIGNAL(clicked()), this,
+    ui->nameLine->setReadOnly(true);
+    ui->addressText->setReadOnly(true);
+    ui->addButton = ui->addButton;
+    ui->submitButton->hide();
+    ui->cancelButton->hide();
+
+//! [setup fields]
+    ui->nextButton->setEnabled(false);
+    ui->previousButton->setEnabled(false);
+//! [setup fields]
+
+    connect(ui->addButton, SIGNAL(clicked()), this,
                 SLOT(addContact()));
-    connect(submitButton, SIGNAL(clicked()), this,
+    connect(ui->submitButton, SIGNAL(clicked()), this,
                 SLOT(submitContact()));
-    connect(cancelButton, SIGNAL(clicked()), this,
+    connect(ui->cancelButton, SIGNAL(clicked()), this,
                 SLOT(cancel()));
 //! [signal slot]
-    connect(nextButton, SIGNAL(clicked()), this,
+    connect(ui->nextButton, SIGNAL(clicked()), this,
                 SLOT(next()));
-    connect(previousButton, SIGNAL(clicked()), this,
+    connect(ui->previousButton, SIGNAL(clicked()), this,
                 SLOT(previous()));
 //! [signal slot]
 
@@ -58,29 +40,29 @@ AddressBook::~AddressBook()
 
 void AddressBook::addContact()
 {
-    oldName = nameLine->text();
-    oldAddress = addressText->toPlainText();
+    oldName = ui->nameLine->text();
+    oldAddress = ui->addressText->toPlainText();
 
-    nameLine->clear();
-    addressText->clear();
+    ui->nameLine->clear();
+    ui->addressText->clear();
 
-    nameLine->setReadOnly(false);
-    nameLine->setFocus(Qt::OtherFocusReason);
-    addressText->setReadOnly(false);
+    ui->nameLine->setReadOnly(false);
+    ui->nameLine->setFocus(Qt::OtherFocusReason);
+    ui->addressText->setReadOnly(false);
 
-    addButton->setEnabled(false);
+    ui->addButton->setEnabled(false);
 //! [disable navigation]
-    nextButton->setEnabled(false);
-    previousButton->setEnabled(false);
+    ui->nextButton->setEnabled(false);
+    ui->previousButton->setEnabled(false);
 //! [disable navigation]
-    submitButton->show();
-    cancelButton->show();
+    ui->submitButton->show();
+    ui->cancelButton->show();
 }
 
 void AddressBook::submitContact()
 {
-    QString name = nameLine->text();
-    QString address = addressText->toPlainText();
+    QString name = ui->nameLine->text();
+    QString address = ui->addressText->toPlainText();
 
     if (name == "" || address == "") {
         QMessageBox::information(this, tr("Empty Field"),
@@ -92,7 +74,6 @@ void AddressBook::submitContact()
         contacts.insert(name, address);
         QMessageBox::information(this, tr("Add Successful"),
             tr("\"%1\" has been added to your address book.").arg(name));
-        return;
     } else {
         QMessageBox::information(this, tr("Add Unsuccessful"),
             tr("Sorry, \"%1\" is already in your address book.").arg(name));
@@ -100,44 +81,44 @@ void AddressBook::submitContact()
     }
 
     if (contacts.isEmpty()) {
-        nameLine->clear();
-        addressText->clear();
+        ui->nameLine->clear();
+        ui->addressText->clear();
     }
 
-    nameLine->setReadOnly(true);
-    addressText->setReadOnly(true);
-    addButton->setEnabled(true);
+    ui->nameLine->setReadOnly(true);
+    ui->addressText->setReadOnly(true);
+    ui->addButton->setEnabled(true);
 
 //! [enable navigation]
     int number = contacts.size();
-    nextButton->setEnabled(number > 1);
-    previousButton->setEnabled(number > 1);
+    ui->nextButton->setEnabled(number > 1);
+    ui->previousButton->setEnabled(number > 1);
 //! [enable navigation]
-    submitButton->hide();
-    cancelButton->hide();
+    ui->submitButton->hide();
+    ui->cancelButton->hide();
 }
 
 void AddressBook::cancel()
 {
-    nameLine->setText(oldName);
-    nameLine->setReadOnly(true);
+    ui->nameLine->setText(oldName);
+    ui->nameLine->setReadOnly(true);
 
-    addressText->setText(oldAddress);
-    addressText->setReadOnly(true);
-    addButton->setEnabled(true);
+    ui->addressText->setText(oldAddress);
+    ui->addressText->setReadOnly(true);
+    ui->addButton->setEnabled(true);
 
     int number = contacts.size();
-    nextButton->setEnabled(number > 1);
-    previousButton->setEnabled(number > 1);
+    ui->nextButton->setEnabled(number > 1);
+    ui->previousButton->setEnabled(number > 1);
 
-    submitButton->hide();
-    cancelButton->hide();
+    ui->submitButton->hide();
+    ui->cancelButton->hide();
 }
 
 //! [next]
 void AddressBook::next()
 {
-    QString name = nameLine->text();
+    QString name = ui->nameLine->text();
     QMap<QString, QString>::iterator i = contacts.find(name);
 
     if (i != contacts.end())
@@ -145,20 +126,20 @@ void AddressBook::next()
     if (i == contacts.end())
         i = contacts.begin();
 
-    nameLine->setText(i.key());
-    addressText->setText(i.value());
+    ui->nameLine->setText(i.key());
+    ui->addressText->setText(i.value());
 }
 //! [next]
 
 //! [previous]
 void AddressBook::previous()
 {
-    QString name = nameLine->text();
+    QString name = ui->nameLine->text();
     QMap<QString, QString>::iterator i = contacts.find(name);
 
     if (i == contacts.end()) {
-        nameLine->clear();
-        addressText->clear();
+        ui->nameLine->clear();
+        ui->addressText->clear();
         return;
     }
 
@@ -166,8 +147,8 @@ void AddressBook::previous()
         i = contacts.end();
 
     i--;
-    nameLine->setText(i.key());
-    addressText->setText(i.value());
+    ui->nameLine->setText(i.key());
+    ui->addressText->setText(i.value());
 }
 //! [previous]
 
diff --git a/doc/examples/addressbook-sdk/part3/addressbook.h b/doc/examples/addressbook-sdk/part3/addressbook.h
index 7d42d0c0531..79b43b9c428 100644
--- a/doc/examples/addressbook-sdk/part3/addressbook.h
+++ b/doc/examples/addressbook-sdk/part3/addressbook.h
@@ -2,11 +2,8 @@
 #define ADDRESSBOOK_H
 
 #include <QtGui/QWidget>
-#include <QtGui/QPushButton>
-#include <QtGui/QLineEdit>
-#include <QtGui/QTextEdit>
 #include <QtGui/QMessageBox>
-
+#include <QtCore/QMap>
 
 namespace Ui
 {
@@ -32,17 +29,6 @@ public slots:
 
 private:
     Ui::AddressBook *ui;
-
-    QPushButton *addButton;
-    QPushButton *submitButton;
-    QPushButton *cancelButton;
-//! [members]
-    QPushButton *nextButton;
-    QPushButton *previousButton;
-//! [members]
-    QLineEdit *nameLine;
-    QTextEdit *addressText;
-
     QMap<QString, QString> contacts;
     QString oldName;
     QString oldAddress;
-- 
GitLab