hgwidgets_pub/hgcacheproxymodel_api/inc/hgdataprovidermodel.h
author hgs
Wed, 06 Oct 2010 14:53:41 +0300
changeset 20 a60f8b6b1d32
permissions -rw-r--r--
201039
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
20
hgs
parents:
diff changeset
     1
/*
hgs
parents:
diff changeset
     2
* Copyright (c) 2009 Nokia Corporation and/or its subsidiary(-ies).
hgs
parents:
diff changeset
     3
* All rights reserved.
hgs
parents:
diff changeset
     4
* This component and the accompanying materials are made available
hgs
parents:
diff changeset
     5
* under the terms of "Eclipse Public License v1.0"
hgs
parents:
diff changeset
     6
* which accompanies this distribution, and is available
hgs
parents:
diff changeset
     7
* at the URL "http://www.eclipse.org/legal/epl-v10.html".
hgs
parents:
diff changeset
     8
*
hgs
parents:
diff changeset
     9
* Initial Contributors:
hgs
parents:
diff changeset
    10
* Nokia Corporation - initial contribution.
hgs
parents:
diff changeset
    11
*
hgs
parents:
diff changeset
    12
* Contributors:
hgs
parents:
diff changeset
    13
*
hgs
parents:
diff changeset
    14
* Description:
hgs
parents:
diff changeset
    15
*
hgs
parents:
diff changeset
    16
*  Version     : %version: 11 %
hgs
parents:
diff changeset
    17
*/
hgs
parents:
diff changeset
    18
#ifndef HGDATAPROVIDERMODEL_H_
hgs
parents:
diff changeset
    19
#define HGDATAPROVIDERMODEL_H_
hgs
parents:
diff changeset
    20
hgs
parents:
diff changeset
    21
#include <QObject>
hgs
parents:
diff changeset
    22
#include <QList>
hgs
parents:
diff changeset
    23
#include <QPair>
hgs
parents:
diff changeset
    24
#include <QPixmap>
hgs
parents:
diff changeset
    25
#include <QMap>
hgs
parents:
diff changeset
    26
#include <QMutex>
hgs
parents:
diff changeset
    27
#include <QAbstractItemModel>
hgs
parents:
diff changeset
    28
hgs
parents:
diff changeset
    29
class HbIcon;
hgs
parents:
diff changeset
    30
class QVariant;
hgs
parents:
diff changeset
    31
class HgCacheProxyModel;
hgs
parents:
diff changeset
    32
hgs
parents:
diff changeset
    33
#ifdef BUILD_CACHEPROXYMODEL
hgs
parents:
diff changeset
    34
#define CACHEPROXYMODEL_EXPORT Q_DECL_EXPORT
hgs
parents:
diff changeset
    35
#else
hgs
parents:
diff changeset
    36
#define CACHEPROXYMODEL_EXPORT Q_DECL_IMPORT
hgs
parents:
diff changeset
    37
#endif
hgs
parents:
diff changeset
    38
hgs
parents:
diff changeset
    39
class HgDataProviderModelObserver
hgs
parents:
diff changeset
    40
{
hgs
parents:
diff changeset
    41
public:
hgs
parents:
diff changeset
    42
    virtual void dataUpdated(int from, int to) = 0;
hgs
parents:
diff changeset
    43
    virtual bool isCached(int idx) const = 0;
hgs
parents:
diff changeset
    44
};
hgs
parents:
diff changeset
    45
hgs
parents:
diff changeset
    46
class CACHEPROXYMODEL_EXPORT HgDataProviderModel : public QAbstractItemModel
hgs
parents:
diff changeset
    47
{
hgs
parents:
diff changeset
    48
    Q_OBJECT
hgs
parents:
diff changeset
    49
hgs
parents:
diff changeset
    50
public:
hgs
parents:
diff changeset
    51
    HgDataProviderModel(QObject *parent = 0);
hgs
parents:
diff changeset
    52
    ~HgDataProviderModel();   
hgs
parents:
diff changeset
    53
//to cooperate with buffer manager    
hgs
parents:
diff changeset
    54
    void release(QList<int> list, bool silent = true);
hgs
parents:
diff changeset
    55
    void request(QList<int> list, bool silent = false);  
hgs
parents:
diff changeset
    56
    virtual void doReleaseData(QList<int> list, bool silent) = 0;
hgs
parents:
diff changeset
    57
    virtual void doRequestData(QList<int> list, bool silent) = 0;  
hgs
parents:
diff changeset
    58
    void registerObserver(HgDataProviderModelObserver* obs);
hgs
parents:
diff changeset
    59
hgs
parents:
diff changeset
    60
public:
hgs
parents:
diff changeset
    61
//from QAbstractItemModel
hgs
parents:
diff changeset
    62
    QModelIndex index(int row, int column,
hgs
parents:
diff changeset
    63
                              const QModelIndex &parent = QModelIndex()) const;
hgs
parents:
diff changeset
    64
    virtual QModelIndex parent(const QModelIndex &child) const;
hgs
parents:
diff changeset
    65
    virtual int rowCount(const QModelIndex &parent = QModelIndex()) const;
hgs
parents:
diff changeset
    66
    virtual int columnCount(const QModelIndex &parent = QModelIndex()) const;
hgs
parents:
diff changeset
    67
    virtual QVariant data(const QModelIndex &index, int role = Qt::DisplayRole) const;
hgs
parents:
diff changeset
    68
    virtual QMap<int, QVariant> itemData(const QModelIndex &index) const;
hgs
parents:
diff changeset
    69
    
hgs
parents:
diff changeset
    70
//cache management    
hgs
parents:
diff changeset
    71
protected:
hgs
parents:
diff changeset
    72
    QVariant data(int idx, int role) const;
hgs
parents:
diff changeset
    73
    void clearCache();
hgs
parents:
diff changeset
    74
    int count() const;
hgs
parents:
diff changeset
    75
    bool update(int pos, QVariant obj, int role, bool silent = false);
hgs
parents:
diff changeset
    76
    bool update(int pos, QList< QPair< QVariant, int > >* list, bool silent = false);    
hgs
parents:
diff changeset
    77
    bool updateIcon(int pos, QVariant obj, bool silent = false);
hgs
parents:
diff changeset
    78
    void resetIcon(int idx);
hgs
parents:
diff changeset
    79
    void newItem(QList< QPair< QVariant, int > >* list = NULL, bool silent = true);
hgs
parents:
diff changeset
    80
    void newItem(QPair< QVariant, int > item, bool silent = true);
hgs
parents:
diff changeset
    81
    void insertItem(int pos, QList< QPair< QVariant, int > >* list = NULL, bool silent = true);
hgs
parents:
diff changeset
    82
    void insertItem(int pos, QPair< QVariant, int > item, bool silent = true);
hgs
parents:
diff changeset
    83
    void clearItem(int pos, bool silent = false);
hgs
parents:
diff changeset
    84
hgs
parents:
diff changeset
    85
private:
hgs
parents:
diff changeset
    86
    void doInsertItem(int pos, QList< QPair< QVariant, int > >* list, bool silent);
hgs
parents:
diff changeset
    87
hgs
parents:
diff changeset
    88
protected:
hgs
parents:
diff changeset
    89
    void removeItem(int pos, bool silent = false);
hgs
parents:
diff changeset
    90
    void removeItems(int pos, int size, bool silent = false);
hgs
parents:
diff changeset
    91
    
hgs
parents:
diff changeset
    92
    virtual QVariant defaultIcon() const = 0;
hgs
parents:
diff changeset
    93
    inline bool containsRole(int idx, int role) const;
hgs
parents:
diff changeset
    94
    inline bool isIndexValid(int idx) const;
hgs
parents:
diff changeset
    95
    bool isCached(int idx) const;
hgs
parents:
diff changeset
    96
public:    
hgs
parents:
diff changeset
    97
    void resetModel();
hgs
parents:
diff changeset
    98
    
hgs
parents:
diff changeset
    99
    enum HgDataProviderIconMode {
hgs
parents:
diff changeset
   100
        HgDataProviderIconHbIcon,
hgs
parents:
diff changeset
   101
        HgDataProviderIconQIcon,
hgs
parents:
diff changeset
   102
        HgDataProviderIconQImage,
hgs
parents:
diff changeset
   103
        HgDataProviderIconQPixmap
hgs
parents:
diff changeset
   104
    };
hgs
parents:
diff changeset
   105
    
hgs
parents:
diff changeset
   106
    void setIconMode(HgDataProviderIconMode mode);
hgs
parents:
diff changeset
   107
    HgDataProviderIconMode iconMode();
hgs
parents:
diff changeset
   108
    
hgs
parents:
diff changeset
   109
protected:    
hgs
parents:
diff changeset
   110
    virtual void doResetModel() {};
hgs
parents:
diff changeset
   111
    virtual QVariant getData(int idx, int role) const {Q_UNUSED(idx); Q_UNUSED(role); return QVariant(); };
hgs
parents:
diff changeset
   112
    
hgs
parents:
diff changeset
   113
// helpers fot emits
hgs
parents:
diff changeset
   114
protected:  
hgs
parents:
diff changeset
   115
    void emitDataChanged(int start, int end, bool silent);
hgs
parents:
diff changeset
   116
    
hgs
parents:
diff changeset
   117
//QPixmap pool
hgs
parents:
diff changeset
   118
public:
hgs
parents:
diff changeset
   119
    void resizeQPixmapPool(int size);
hgs
parents:
diff changeset
   120
    
hgs
parents:
diff changeset
   121
protected:  
hgs
parents:
diff changeset
   122
    void releasePixmap(int idx);
hgs
parents:
diff changeset
   123
    QVariant createIcon(int index, QPixmap aPixmap);
hgs
parents:
diff changeset
   124
hgs
parents:
diff changeset
   125
private:
hgs
parents:
diff changeset
   126
    QPixmap* getPixmap(int idx);
hgs
parents:
diff changeset
   127
hgs
parents:
diff changeset
   128
    
hgs
parents:
diff changeset
   129
private:
hgs
parents:
diff changeset
   130
    QList<QMap<int, QVariant>*>* mCache;   
hgs
parents:
diff changeset
   131
    int mCacheSize; //Number of cached Icons. Not same as mCache->count()
hgs
parents:
diff changeset
   132
    QList< QPixmap* > mFreePixmaps;
hgs
parents:
diff changeset
   133
    QMap< int, QPixmap* > mUsedPixmaps;    
hgs
parents:
diff changeset
   134
    int mUnallocatedPixmaps;
hgs
parents:
diff changeset
   135
    QMutex mQPixmapsLock;
hgs
parents:
diff changeset
   136
    QMutex mDataLock;    
hgs
parents:
diff changeset
   137
    HgDataProviderModelObserver *mObserver;
hgs
parents:
diff changeset
   138
    HgDataProviderIconMode mIconMode;
hgs
parents:
diff changeset
   139
};
hgs
parents:
diff changeset
   140
hgs
parents:
diff changeset
   141
inline bool HgDataProviderModel::isIndexValid(int idx) const
hgs
parents:
diff changeset
   142
{
hgs
parents:
diff changeset
   143
    return ((idx >= 0) && 
hgs
parents:
diff changeset
   144
            (idx < mCache->size()) && 
hgs
parents:
diff changeset
   145
            (mCache->at(idx))); 
hgs
parents:
diff changeset
   146
}
hgs
parents:
diff changeset
   147
hgs
parents:
diff changeset
   148
inline bool HgDataProviderModel::containsRole(int idx, int role) const
hgs
parents:
diff changeset
   149
{
hgs
parents:
diff changeset
   150
    return ( isIndexValid(idx) && 
hgs
parents:
diff changeset
   151
             mCache->at(idx)->contains(role) ); 
hgs
parents:
diff changeset
   152
}
hgs
parents:
diff changeset
   153
hgs
parents:
diff changeset
   154
#endif // HGDATAPROVIDERMODEL_H_