/****************************************************************************
**
** 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()
{
#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);
//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())
{
#ifdef SYMBIAN_BACKEND_USE_SQLITE
// Inlcude a comma if needed in the display label
if (m_nameOrder == CntOrderLastCommaFirst)
displayLabel.append(comma());
#endif
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