examples/samplephonebook/contacteditor.cpp
changeset 0 876b1a06bc25
--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/examples/samplephonebook/contacteditor.cpp	Wed Aug 25 15:49:42 2010 +0300
@@ -0,0 +1,331 @@
+/****************************************************************************
+**
+** Copyright (C) 2010 Nokia Corporation and/or its subsidiary(-ies).
+** All rights reserved.
+** Contact: Nokia Corporation (qt-info@nokia.com)
+**
+** This file is part of the Qt Mobility Components.
+**
+** $QT_BEGIN_LICENSE:BSD$
+** You may use this file under the terms of the BSD license as follows:
+**
+** "Redistribution and use in source and binary forms, with or without
+** modification, are permitted provided that the following conditions are
+** met:
+**   * Redistributions of source code must retain the above copyright
+**     notice, this list of conditions and the following disclaimer.
+**   * Redistributions in binary form must reproduce the above copyright
+**     notice, this list of conditions and the following disclaimer in
+**     the documentation and/or other materials provided with the
+**     distribution.
+**   * Neither the name of Nokia Corporation and its Subsidiary(-ies) nor
+**     the names of its contributors may be used to endorse or promote
+**     products derived from this software without specific prior written
+**     permission.
+**
+** THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
+** "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
+** LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
+** A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
+** OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
+** SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
+** LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
+** DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
+** THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
+** (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
+** OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE."
+** $QT_END_LICENSE$
+**
+****************************************************************************/
+
+#include "contacteditor.h"
+
+#include <QtGui>
+
+const int MAX_AVATAR_DISPLAY_SIZE = 120;
+
+ContactEditor::ContactEditor(QWidget *parent)
+        :QWidget(parent)
+{
+    m_manager = 0;
+    m_contactId = QContactLocalId(0);
+
+    m_nameEdit = new QLineEdit(this);
+    m_phoneEdit = new QLineEdit(this);
+    m_emailEdit = new QLineEdit(this);
+    m_addrEdit = new QLineEdit(this);
+    m_avatarBtn = new QPushButton(tr("Set picture"), this);
+    m_clearAvatarBtn = new QPushButton(tr("Clear"), this);
+    m_avatarView = new QLabel(this);
+    connect(m_avatarBtn, SIGNAL(clicked()), this, SLOT(avatarClicked()));
+    connect(m_clearAvatarBtn, SIGNAL(clicked()), this, SLOT(clearAvatarClicked()));
+
+    QFormLayout *detailsLayout = new QFormLayout;
+    QLabel *nameLabel = new QLabel(tr("Name"), this);
+    QLabel *phoneLabel = new QLabel(tr("Phone"), this);
+    QLabel *emailLabel = new QLabel(tr("Email"), this);
+    QLabel *addressLabel = new QLabel(tr("Address"), this);
+    QLabel *avatarLabel = new QLabel(tr("Picture"), this);
+    QHBoxLayout *avatarBtnLayout = new QHBoxLayout;
+    avatarBtnLayout->addWidget(m_avatarBtn);
+    avatarBtnLayout->addWidget(m_clearAvatarBtn);
+    if (QApplication::desktop()->availableGeometry().width() < 360) {
+        // Narrow screen: put label on separate line to textbox
+        detailsLayout->addRow(nameLabel);
+        detailsLayout->addRow(m_nameEdit);
+        detailsLayout->addRow(phoneLabel);
+        detailsLayout->addRow(m_phoneEdit);
+        detailsLayout->addRow(emailLabel);
+        detailsLayout->addRow(m_emailEdit);
+        detailsLayout->addRow(addressLabel);
+        detailsLayout->addRow(m_addrEdit);
+        detailsLayout->addRow(avatarLabel);
+        detailsLayout->addRow(avatarBtnLayout);
+        detailsLayout->addRow(m_avatarView);
+    } else {
+        // Wide screen: put label on same line as textbox
+        detailsLayout->addRow(nameLabel, m_nameEdit);
+        detailsLayout->addRow(phoneLabel, m_phoneEdit);
+        detailsLayout->addRow(emailLabel, m_emailEdit);
+        detailsLayout->addRow(addressLabel, m_addrEdit);
+        detailsLayout->addRow(avatarLabel, avatarBtnLayout);
+        detailsLayout->addRow("", m_avatarView);
+    }
+    detailsLayout->setFieldGrowthPolicy(QFormLayout::ExpandingFieldsGrow);
+    detailsLayout->setSizeConstraint(QLayout::SetMinAndMaxSize);
+
+    QScrollArea *detailsScrollArea = new QScrollArea(this);
+    detailsScrollArea->setWidgetResizable(true);
+    QWidget *detailsContainer = new QWidget(detailsScrollArea);
+    detailsContainer->setLayout(detailsLayout);
+    detailsScrollArea->setWidget(detailsContainer);
+
+    QVBoxLayout *editLayout = new QVBoxLayout;
+    editLayout->addWidget(detailsScrollArea);
+
+#ifdef Q_OS_SYMBIAN
+    // In symbian "save" and "cancel" buttons are softkeys.
+    m_saveBtn = new QAction(tr("Save"), this);
+    m_saveBtn->setSoftKeyRole(QAction::PositiveSoftKey);
+    addAction(m_saveBtn);
+    connect(m_saveBtn, SIGNAL(triggered(bool)), this, SLOT(saveClicked()));
+    m_cancelBtn = new QAction(tr("Cancel"), this);
+    m_cancelBtn->setSoftKeyRole(QAction::NegativeSoftKey);
+    addAction(m_cancelBtn);
+    connect(m_cancelBtn, SIGNAL(triggered(bool)), this, SLOT(cancelClicked()));
+#else
+    m_saveBtn = new QPushButton(tr("&Save"), this);
+    m_saveBtn->setDefault(true);
+    connect(m_saveBtn, SIGNAL(clicked()), this, SLOT(saveClicked()));
+    m_cancelBtn = new QPushButton(tr("&Cancel"), this);
+    connect(m_cancelBtn, SIGNAL(clicked()), this, SLOT(cancelClicked()));
+    QHBoxLayout *btnLayout = new QHBoxLayout;
+    btnLayout->addWidget(m_saveBtn);
+    btnLayout->addWidget(m_cancelBtn);
+    editLayout->addLayout(btnLayout);
+#endif
+
+    setLayout(editLayout);
+}
+
+ContactEditor::~ContactEditor()
+{
+}
+
+void ContactEditor::setCurrentContact(QContactManager* manager, QContactLocalId currentId)
+{
+    m_manager = manager;
+    m_contactId = currentId;
+    m_newAvatarPath = QString();
+
+    // Clear UI
+    m_nameEdit->clear();
+    m_phoneEdit->clear();
+    m_emailEdit->clear();
+    m_addrEdit->clear();
+
+    if (manager == 0) {
+        m_saveBtn->setEnabled(false);
+        return;
+    }
+
+    // enable the UI.
+    m_saveBtn->setEnabled(true);
+
+    // otherwise, build from the contact details.
+    QContact curr;
+    if (m_contactId != QContactLocalId(0))
+        curr = manager->contact(m_contactId);
+
+    // Disable fields & buttons according to what the backend supports
+    QMap<QString, QContactDetailDefinition> defs = m_manager->detailDefinitions(QContactType::TypeContact);
+
+    // name
+    //QContactName nm = curr.detail(QContactName::DefinitionName);
+    if (m_contactId != QContactLocalId(0))
+        m_nameEdit->setText(manager->synthesizedContactDisplayLabel(curr));
+
+    // phonenumber
+    QContactPhoneNumber phn = curr.detail(QContactPhoneNumber::DefinitionName);
+    m_phoneEdit->setText(phn.value(QContactPhoneNumber::FieldNumber));
+
+    // email
+    if (defs.contains(QContactEmailAddress::DefinitionName)) {
+        QContactEmailAddress em = curr.detail(QContactEmailAddress::DefinitionName);
+        m_emailEdit->setText(em.value(QContactEmailAddress::FieldEmailAddress));
+        m_emailEdit->setReadOnly(false);
+    } else {
+        m_emailEdit->setText("<not supported>");
+        m_emailEdit->setReadOnly(true);
+    }
+
+    // address
+    if (defs.contains(QContactAddress::DefinitionName)) {
+        QContactAddress adr = curr.detail(QContactAddress::DefinitionName);
+        m_addrEdit->setText(adr.value(QContactAddress::FieldStreet)); // ugly hack.
+        m_addrEdit->setReadOnly(false);
+    } else {
+        m_addrEdit->setText("<not supported>");
+        m_addrEdit->setReadOnly(true);
+    }
+
+    // avatar viewer
+    if (defs.contains(QContactAvatar::DefinitionName)
+        || defs.contains(QContactThumbnail::DefinitionName)) {
+        m_avatarBtn->setEnabled(true);
+        QContactAvatar av = curr.detail(QContactAvatar::DefinitionName);
+        QContactThumbnail thumb = curr.detail(QContactThumbnail::DefinitionName);
+        m_avatarView->clear();
+        m_newAvatarPath = av.imageUrl().toLocalFile();
+        m_thumbnail = thumb.thumbnail();
+        if (m_thumbnail.isNull()) {
+            if (m_newAvatarPath.isEmpty()) {
+                m_avatarView->clear();
+                m_clearAvatarBtn->setDisabled(true);
+            } else {
+                setAvatarPixmap(QPixmap(av.imageUrl().toLocalFile()));
+                m_thumbnail = QImage(av.imageUrl().toLocalFile());
+            }
+        } else {
+            setAvatarPixmap(QPixmap::fromImage(m_thumbnail));
+        }
+    } else {
+        m_avatarBtn->setDisabled(true);
+        m_clearAvatarBtn->setDisabled(true);
+    }
+}
+
+QString ContactEditor::nameField()
+{
+    // return the field which the name data should be saved in.
+    if (!m_manager)
+        return QString();
+
+    QMap<QString, QContactDetailDefinition> defs = m_manager->detailDefinitions(QContactType::TypeContact);
+    QContactDetailDefinition nameDef = defs.value(QContactName::DefinitionName);
+    if (nameDef.fields().keys().contains(QContactName::FieldCustomLabel)) {
+        return QString(QLatin1String(QContactName::FieldCustomLabel));
+    } else if (nameDef.fields().keys().contains(QContactName::FieldFirstName)) {
+        return QString(QLatin1String(QContactName::FieldFirstName));
+    } else {
+        return QString();
+    }
+}
+
+void ContactEditor::setAvatarPixmap(const QPixmap &pixmap)
+{
+    if (pixmap.isNull())
+        return;
+    QPixmap scaled = pixmap.scaled(QSize(MAX_AVATAR_DISPLAY_SIZE, MAX_AVATAR_DISPLAY_SIZE),
+                                   Qt::KeepAspectRatio,
+                                   Qt::SmoothTransformation);
+    m_avatarView->setPixmap(scaled);
+    m_avatarView->setMaximumSize(scaled.size());
+    m_clearAvatarBtn->setEnabled(true);
+}
+
+void ContactEditor::clearAvatarClicked()
+{
+    m_avatarView->clear();
+    m_thumbnail = QImage();
+    m_newAvatarPath.clear();
+    m_clearAvatarBtn->setDisabled(true);
+}
+
+void ContactEditor::avatarClicked()
+{
+    // put up a file dialog, and update the new avatar path.
+    QString fileName = QFileDialog::getOpenFileName(this,
+       tr("Select Contact Picture"), ".", tr("Image Files (*.png *.jpg *.bmp)"));
+
+    if (!fileName.isEmpty()) {
+        m_newAvatarPath = fileName;
+        m_thumbnail = QImage(m_newAvatarPath);
+        setAvatarPixmap(QPixmap::fromImage(m_thumbnail));
+    }
+}
+
+void ContactEditor::saveClicked()
+{
+    if (!m_manager) {
+        qWarning() << "No manager selected; cannot save.";
+    } else {
+        QContact curr;
+        if (m_contactId != QContactLocalId(0))
+            curr = m_manager->contact(m_contactId);
+
+        if (m_nameEdit->text().isEmpty()) {
+            QMessageBox::information(this, "Failed!", "You must give a name for the contact!");
+            return;
+        }
+
+        if (m_nameEdit->text() != m_manager->synthesizedContactDisplayLabel(curr)) {
+            // if the name has changed (ie, is different to the synthed label) then save it as a custom label.
+            QString saveNameField = nameField();
+            if (!saveNameField.isEmpty()) {
+                QContactName nm = curr.detail(QContactName::DefinitionName);
+                nm.setValue(saveNameField, m_nameEdit->text());
+                curr.saveDetail(&nm);
+            }
+        }
+
+        QContactPhoneNumber phn = curr.detail(QContactPhoneNumber::DefinitionName);
+        phn.setNumber(m_phoneEdit->text());
+        curr.saveDetail(&phn);
+
+        if (!m_emailEdit->isReadOnly()) {
+            QContactEmailAddress em = curr.detail(QContactEmailAddress::DefinitionName);
+            em.setEmailAddress(m_emailEdit->text());
+            curr.saveDetail(&em);
+        }
+
+        if (!m_addrEdit->isReadOnly()) {
+            QContactAddress adr = curr.detail(QContactAddress::DefinitionName);
+            adr.setStreet(m_addrEdit->text());
+            curr.saveDetail(&adr);
+        }
+
+        if (m_avatarBtn->isEnabled()) {
+            QContactAvatar av = curr.detail(QContactAvatar::DefinitionName);
+            av.setImageUrl(QUrl(m_newAvatarPath));
+            curr.saveDetail(&av);
+
+            QContactThumbnail thumb = curr.detail(QContactThumbnail::DefinitionName);
+            QImage img(m_thumbnail);
+            thumb.setThumbnail(img);
+            curr.saveDetail(&thumb);
+        }
+
+        curr = m_manager->compatibleContact(curr);
+        bool success = m_manager->saveContact(&curr);
+        if (!success)
+            QMessageBox::information(this, "Failed!", QString("Failed to save contact!\n(error code %1)").arg(m_manager->error()));
+    }
+
+    emit showListPage();
+}
+
+void ContactEditor::cancelClicked()
+{
+    emit showListPage();
+}