1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
|
/*********
*
* In the name of the Father, and of the Son, and of the Holy Spirit.
*
* This file is part of BibleTime's source code, http://www.bibletime.info/.
*
* Copyright 1999-2011 by the BibleTime developers.
* The BibleTime source code is licensed under the GNU General Public License
* version 2.0.
*
**********/
#ifndef BTBOOKSHELFMODEL_H
#define BTBOOKSHELFMODEL_H
#include <QAbstractListModel>
#include "backend/drivers/cswordmoduleinfo.h"
/**
Implements a simple list model projecting CSwordModuleInfo instances. This model is mostly
implemented to provide an interface the the underlying data and to provide notifications
when modules are added, removed or changed. If you want to use a model for widgets, the
BtBookshelfTreeModel might be a better choice, since it also provides sorting and grouping.
*/
class BtBookshelfModel: public QAbstractListModel {
Q_OBJECT
public:
enum ModuleRole {
ModuleNameRole = Qt::DisplayRole,
ModuleIconRole = Qt::DecorationRole,
ModulePointerRole = Qt::UserRole,
ModuleCategoryRole = Qt::UserRole + 1,
ModuleLanguageRole = Qt::UserRole + 2,
ModuleHiddenRole = Qt::UserRole + 3,
ModuleInstallPathRole = Qt::UserRole + 4,
ModuleHasIndexRole = Qt::UserRole + 5,
ModuleIndexSizeRole = Qt::UserRole + 6,
ModuleDescriptionRole = Qt::UserRole + 7,
UserRole = Qt::UserRole + 100
};
public:
BtBookshelfModel(QObject *parent = 0);
~BtBookshelfModel();
// Virtual methods implemented from QAbstractListModel:
int rowCount(const QModelIndex &parent = QModelIndex()) const;
QVariant data(CSwordModuleInfo *module, int role) const;
QVariant data(const QModelIndex &index, int role) const;
QVariant headerData(int section, Qt::Orientation orientation,
int role = Qt::DisplayRole) const;
bool setData(const QModelIndex &index, const QVariant &value,
int role = ModuleHiddenRole);
/**
Given an index of this model, this method returns a pointer to the underlying
CSwordModuleInfo instance corresponding to the given index.
\param[in] index An index to this model.
*/
inline CSwordModuleInfo *module(const QModelIndex &index) const {
return (CSwordModuleInfo *)
data(index, BtBookshelfModel::ModulePointerRole)
.value<void *>();
}
/**
Clears the data of the whole model by removing all items.
\param[in] destroy If true, all CSwordModuleInfo instances in this model are also
destroyed.
*/
void clear(bool destroy = false);
/**
Appends the given module to this model.
\param[in] module Module to add.
*/
void addModule(CSwordModuleInfo * const module);
/**
Appends the all the modules in the given set to this model.
\param[in] modules Set of modules to add.
*/
void addModules(const QSet<CSwordModuleInfo *> &modules);
/**
Appends the all the modules in the given list to this model.
\param[in] modules Set of modules to add.
*/
void addModules(const QList<CSwordModuleInfo *> &modules);
/**
Removes the given module from this model and optionally destroys it.
\param[in] module The module to remove from this model.
\param[in] destroy If true, the given CSwordModuleInfo instance is destroyed.
*/
void removeModule(CSwordModuleInfo * const module,
bool destroy = false);
/**
Removes all modules from the given set from this model and optionally destroys
them.
\param[in] modules The set of modules to remove from this model.
\param[in] destroy If true, the given CSwordModuleInfo instances are destroyed.
*/
void removeModules(const QSet<CSwordModuleInfo *> &modules,
bool destroy = false);
/**
Removes all modules from the given list from this model and optionally destroys
them.
\param[in] modules The list of modules to remove from this model.
\param[in] destroy If true, the given CSwordModuleInfo instances are destroyed.
*/
void removeModules(const QList<CSwordModuleInfo *> &modules,
bool destroy = false);
/**
Returns the first module found with the given name.
\param[in] name Name of the module to find.
*/
CSwordModuleInfo* getModule(const QString &name) const;
/**
Returns the list of handled modules as a list of CSwordModuleInfo* pointers.
*/
inline const QList<CSwordModuleInfo *> &moduleList() const {
return m_data;
}
protected slots:
/**
Slot DIRECTLY called by CSwordModuleInfo when the hidden status of the respective
module changes.
\param[in] hidden True, if the module was hidden; false, if the module was shown.
*/
void moduleHidden(bool hidden);
/**
Slot DIRECTLY called by CSwordModuleInfo when the indexed status of the respective
module changes.
\param[in] indexed True, if the module was indexed; false if the index was deleted.
*/
void moduleIndexed(bool indexed);
/**
Slot DIRECTLY called by CSwordModuleInfo when the locked status of the respective
module changes.
\param[in] unlocked True, if the module was unlocked; false if the module was
locked.
*/
void moduleUnlocked(bool unlocked);
protected:
/**
Called internally when module data changes. This method emits any neccessary
signals for this model.
\pre The givem module is handled by this model.
\param[in] module The module that changed status.
*/
void moduleDataChanged(CSwordModuleInfo *module);
protected:
/**
The underlying data as a list of pointers to the respective CSwordModuleInfo
instances.
*/
QList<CSwordModuleInfo *> m_data;
};
#endif // BTBOOKSHELFMODEL_H
|
