/*

* 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;

/*!

 * 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

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:

private:

    // Construction helpers

    int doConstruct();

    int initializeData();

    void updateContactIdsArray();

    // Data manipulation

    QContact contact(int row) const;

    // Utility

    bool validRowId(int row) const;

    int rowId(const QContactLocalId &contactId) const;

    QVariant dataForDisplayRole(int row) const;

    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);

private:

    QSharedDataPointer<CntListModelData>  d;

};

#endif