--- /dev/null Thu Jan 01 00:00:00 1970 +0000
+++ b/plugins/contacts/symbian/plugin/src/cntdisplaylabel.cpp Wed Aug 25 15:49:42 2010 +0300
@@ -0,0 +1,292 @@
+/****************************************************************************
+**
+** 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 QtCore module of the Qt Toolkit.
+**
+** $QT_BEGIN_LICENSE:LGPL$
+** No Commercial Usage
+** This file contains pre-release code and may not be distributed.
+** You may use this file in accordance with the terms and conditions
+** contained in the Technology Preview License Agreement accompanying
+** this package.
+**
+** GNU Lesser General Public License Usage
+** Alternatively, this file may be used under the terms of the GNU Lesser
+** General Public License version 2.1 as published by the Free Software
+** Foundation and appearing in the file LICENSE.LGPL included in the
+** packaging of this file. Please review the following information to
+** ensure the GNU Lesser General Public License version 2.1 requirements
+** will be met: http://www.gnu.org/licenses/old-licenses/lgpl-2.1.html.
+**
+** In addition, as a special exception, Nokia gives you certain additional
+** rights. These rights are described in the Nokia Qt LGPL Exception
+** version 1.1, included in the file LGPL_EXCEPTION.txt in this package.
+**
+** If you have questions regarding the use of this file, please contact
+** Nokia at qt-info@nokia.com.
+**
+**
+**
+**
+**
+**
+**
+**
+** $QT_END_LICENSE$
+**
+****************************************************************************/
+
+#include "cntdisplaylabel.h"
+#include <qtcontacts.h>
+
+/*!
+ * Constructor
+ */
+
+CntDisplayLabel::CntDisplayLabel() :
+m_nameOrder(CntOrderFirstLast)
+{
+#ifdef SYMBIAN_BACKEND_USE_SQLITE
+ m_settings = new CntCenrep(KCntNameOrdering, *this);
+ m_nameOrder = m_settings->getValue();
+#endif
+ setDisplayLabelDetails();
+}
+
+/*!
+ * Destructor
+ */
+CntDisplayLabel::~CntDisplayLabel()
+{
+#ifdef SYMBIAN_BACKEND_USE_SQLITE
+ delete m_settings;
+#endif
+}
+
+/*!
+ * Sets the fields that should be used for displaylabel
+ *
+ * The order is defined in the QList of preferred options
+ * Whereas the QPair includes the fields that should be used for
+ * the specific detail
+ */
+void CntDisplayLabel::setDisplayLabelDetails()
+{
+ //This will be variated in the future
+ //adds the contact's details definition names + fields to be used for display name and filtering display label
+
+ //Display label details
+ //Contact
+ //Preferred details
+ m_contactDisplayLabelDetails.clear();
+ m_groupDisplayLabelDetails.clear();
+ QList<QPair<QLatin1String, QLatin1String> > contactPrefferedDisplayLabelDetails;
+ QLatin1String firstLatin(QContactName::FieldFirstName);
+ QLatin1String secondLatin(QContactName::FieldLastName);
+
+#ifdef SYMBIAN_BACKEND_USE_SQLITE
+ if (m_nameOrder == CntOrderLastFirst || m_nameOrder == CntOrderLastCommaFirst) {
+ firstLatin = QLatin1String(QContactName::FieldLastName);
+ secondLatin = QLatin1String(QContactName::FieldFirstName);
+ }
+#endif
+
+ contactPrefferedDisplayLabelDetails.append(qMakePair(QLatin1String(QContactName::DefinitionName), firstLatin));
+ contactPrefferedDisplayLabelDetails.append(qMakePair(QLatin1String(QContactName::DefinitionName), secondLatin));
+ m_contactDisplayLabelDetails.append(contactPrefferedDisplayLabelDetails);
+
+ //if preferred details doesn't exist use these
+ QList<QPair<QLatin1String, QLatin1String> > contactSecondaryDisplayLabelDetails;
+ contactSecondaryDisplayLabelDetails.append(qMakePair(QLatin1String(QContactOrganization::DefinitionName), QLatin1String(QContactOrganization::FieldName)));
+ m_contactDisplayLabelDetails.append(contactSecondaryDisplayLabelDetails);
+
+ //Group
+ QList<QPair<QLatin1String, QLatin1String> > preferredGroupDisplayLabelDetails;
+ preferredGroupDisplayLabelDetails.append(qMakePair(QLatin1String(QContactName::DefinitionName), QLatin1String(QContactName::FieldCustomLabel)));
+ m_groupDisplayLabelDetails.append(preferredGroupDisplayLabelDetails);
+}
+
+/*!
+ * Returns a synthesised display label of a contact
+ * \a contact to read the data from .
+ * \a error On return, contains the possible error.
+ * \return synthesised display label
+ */
+QString CntDisplayLabel::synthesizedDisplayLabel(const QContact& contact, QContactManager::Error* error)
+{
+ QString displayLabel;
+ *error = QContactManager::NoError;
+
+#ifdef SYMBIAN_BACKEND_USE_SQLITE
+ int value = m_settings->getValue();
+ if (value != -1 && value != m_nameOrder) {
+ m_nameOrder = value;
+ setDisplayLabelDetails();
+ }
+#endif
+ //contact
+ if(contact.type() == QContactType::TypeContact) {
+ displayLabel = generateDisplayLabel(contact, m_contactDisplayLabelDetails);
+ }
+
+ //group
+ else if (contact.type() == QContactType::TypeGroup) {
+ displayLabel = generateDisplayLabel(contact, m_groupDisplayLabelDetails);
+ }
+
+ //invalid type
+ else {
+ *error = QContactManager::InvalidContactTypeError;
+ }
+
+ return displayLabel;
+}
+
+/*!
+ * Generate the display label
+ * \a contact to read the data from .
+ * \a detailList contains the details to be read from the contact
+ * \return synthesised display label
+ */
+QString CntDisplayLabel::generateDisplayLabel( const QContact &contact, const QList<QList<QPair<QLatin1String, QLatin1String> > > detailList) const
+{
+ // Default to empty display label. It is up to the client to create a
+ // localised presentation of a contact without a name.
+ QString displayLabel("");
+
+ //loop through the details and create display label
+ for(int i = 0; i < detailList.count() && displayLabel.isEmpty(); i++ )
+ {
+ QList<QPair<QLatin1String, QLatin1String> > detailPairList = detailList.at(i);
+ QContactDetail contactDetail;
+
+ for(int j = 0; j < detailPairList.count(); j++)
+ {
+ contactDetail = contact.detail(detailPairList.at(j).first);
+
+ if(displayLabel.isEmpty()){ //read the value and set it as display label
+ displayLabel = contactDetail.value(detailPairList.at(j).second);
+ }
+ else{ //read the value and append it to the display label
+ QString label = contactDetail.value(detailPairList.at(j).second);
+
+ if(!label.isEmpty())
+ {
+ // Inlcude a comma if needed in the display label
+ if (m_nameOrder == CntOrderLastCommaFirst)
+ displayLabel.append(comma());
+ displayLabel.append(delimiter());
+ displayLabel.append(label);
+ }
+ }
+ }
+ }
+
+ return displayLabel;
+}
+
+/*!
+ * delemiter to be used in display label
+ * \return delemiter
+ */
+QString CntDisplayLabel::delimiter() const
+{
+ //this will be variated in the future.
+ return " ";
+}
+
+/*!
+ * Returns the details to be used for contact filtering
+ */
+QList<QPair<QLatin1String, QLatin1String> > CntDisplayLabel::contactFilterDetails() const
+{
+ return m_contactDisplayLabelDetails.at(0);
+}
+
+/*!
+ * Returns the details to be used for group filtering
+ */
+QList<QPair<QLatin1String, QLatin1String> > CntDisplayLabel::groupFilterDetails() const
+{
+ return m_groupDisplayLabelDetails.at(0);
+}
+
+/*!
+ * Comma to be used in display label
+ * \return comma
+ */
+QString CntDisplayLabel::comma() const
+{
+ return ",";
+}
+
+#ifdef SYMBIAN_BACKEND_USE_SQLITE
+
+void CntDisplayLabel::updateNameOrdering()
+{
+ emit displayLabelChanged();
+}
+
+CntCenrep::CntCenrep(const TUint32 aKey, CntDisplayLabel& aDisplayLabel) :
+ CActive(EPriorityStandard),
+ iCenrep(NULL),
+ iDisplayLabel(&aDisplayLabel),
+ iKey(aKey)
+{
+ TRAPD(error, iCenrep = CRepository::NewL(KCRCntSettings));
+
+ if ( error == KErrNone ) {
+ CActiveScheduler::Add(this);
+
+ // initial subscription and process current property value
+ iCenrep->NotifyRequest(iKey, iStatus );
+ SetActive();
+ }
+
+ iValue = getValue();
+}
+
+CntCenrep::~CntCenrep()
+{
+ Cancel();
+ delete iCenrep;
+}
+
+int CntCenrep::getValue()
+{
+ TInt value;
+ if (iCenrep && iCenrep->Get(iKey, value) == KErrNone) {
+ return value;
+ } else {
+ return -1;
+ }
+}
+
+void CntCenrep::DoCancel()
+{
+ if (iCenrep)
+ iCenrep->NotifyCancel(iKey);
+}
+
+TInt CntCenrep::RunError(TInt aError)
+{
+ return aError;
+}
+
+void CntCenrep::RunL()
+{
+ // resubscribe before processing new value to prevent missing updates
+ iCenrep->NotifyRequest(iKey, iStatus );
+ SetActive();
+
+ int value = getValue();
+ if (value != -1 && value != iValue) {
+ iValue = value;
+ iDisplayLabel->updateNameOrdering();
+ }
+}
+
+#endif