phonebookengines/cntlistmodel/inc/cntlistmodel.h
author Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
Wed, 23 Jun 2010 18:02:44 +0300
changeset 46 efe85016a067
parent 40 b46a585f6909
child 47 7cbcb2896f0e
permissions -rw-r--r--
Revision: 201023 Kit: 2010125

/*
* Copyright (c) 2009 Nokia Corporation and/or its subsidiary(-ies).
* All rights reserved.
* This component and the accompanying materials are made available
* under the terms of "Eclipse Public License v1.0"
* which accompanies this distribution, and is available
* at the URL "http://www.eclipse.org/legal/epl-v10.html".
*
* Initial Contributors:
* Nokia Corporation - initial contribution.
*
* Contributors:
*
* Description:
*
*/
#ifndef CNTLISTMODEL_H
#define CNTLISTMODEL_H

#include <QAbstractListModel>
#include <QSharedData>
#include <HbIcon>

#include "cntlistmodelglobal.h"
#include <qcontactmanager.h>
#include <qcontactfilter.h>
#include <qcontactsortorder.h>

QTM_USE_NAMESPACE

class CntListModelData;

/*!
 * CntListModel is a list model view for contacts database
 * content. It will cache contacts database entries to be
 * displayed on the screen.
 *
 * Note that that this is a prototype implementation and does
 * not yet support more advanced features, such as automatic
 * update and lazy fetching from contacts database.
 */
class CNTLISTMODEL_EXPORT CntListModel : public QAbstractListModel
{
    Q_OBJECT
    friend class TestCntListModel;

public:
    CntListModel(const QContactFilter& contactFilter = QContactFilter(),
                bool showMyCard = true,
                QObject *parent = 0);
    CntListModel(QContactManager* manager,
                const QContactFilter& contactFilter = QContactFilter(),
                bool showMyCard = true,
                QObject *parent = 0);
    ~CntListModel();

public: // from QAbstractTableModel/QAbstractItemModel
    QVariant data(const QModelIndex &index, int role) const;
    int rowCount(const QModelIndex &parent = QModelIndex()) const;

public:
	QContact contact(const QModelIndex &index) const;
	QModelIndex indexOfContact(const QContact &contact) const;
	QContactManager& contactManager() const;
	void setFilter(const QContactFilter& contactFilter = QContactFilter());
	void showMyCard(bool enabled);
	bool myCardStatus() const;
	QContactLocalId myCardId() const;
	
private:
    // Construction helpers
    int doConstruct();
    int initializeData();
    void updateContactIdsArray();
    void setSortOrder();

    // Data manipulation
    QContact contact(int row) const;

    // Utility
    bool validRowId(int row) const;
    int rowId(const QContactLocalId &contactId) const;
    QVariant dataForDisplayRole(int row) const;

private slots:
    void handleAdded(const QList<QContactLocalId>& contactIds);
    void handleChanged(const QList<QContactLocalId>& contactIds);
    void handleRemoved(const QList<QContactLocalId>& contactIds);
    void handleMyCardChanged(const QContactLocalId& oldId, const QContactLocalId& newId);
    void handleContactInfoUpdated(QContactLocalId contactId);
    void refreshModel();

private:
    QSharedDataPointer<CntListModelData>  d;
    HbIcon                               m_defaultIcon;
    HbIcon                               m_defaultMyCardIcon;
};

#endif