![]() |
LeechCraft
%{LEECHCRAFT_VERSION}
Modular cross-platform feature rich live environment.
|
#include "mergemodel.h"
Public Types | |
typedef models_t::iterator | iterator |
typedef models_t::const_iterator | const_iterator |
Public Slots | |
virtual void | handleColumnsAboutToBeInserted (const QModelIndex &, int, int) |
virtual void | handleColumnsAboutToBeRemoved (const QModelIndex &, int, int) |
virtual void | handleColumnsInserted (const QModelIndex &, int, int) |
virtual void | handleColumnsRemoved (const QModelIndex &, int, int) |
virtual void | handleDataChanged (const QModelIndex &, const QModelIndex &) |
virtual void | handleRowsAboutToBeInserted (const QModelIndex &, int, int) |
virtual void | handleRowsAboutToBeRemoved (const QModelIndex &, int, int) |
virtual void | handleRowsInserted (const QModelIndex &, int, int) |
virtual void | handleRowsRemoved (const QModelIndex &, int, int) |
virtual void | handleModelAboutToBeReset () |
virtual void | handleModelReset () |
Public Member Functions | |
MergeModel (const QStringList &headers, QObject *parent=0) | |
Constructs the merge model. More... | |
virtual int | columnCount (const QModelIndex &=QModelIndex()) const |
virtual QVariant | headerData (int, Qt::Orientation, int=Qt::DisplayRole) const |
virtual QVariant | data (const QModelIndex &, int=Qt::DisplayRole) const |
virtual Qt::ItemFlags | flags (const QModelIndex &) const |
virtual QModelIndex | index (int, int, const QModelIndex &=QModelIndex()) const |
virtual QModelIndex | parent (const QModelIndex &) const |
virtual int | rowCount (const QModelIndex &=QModelIndex()) const |
QStringList | mimeTypes () const |
Returns the union of MIME types of the models. More... | |
QMimeData * | mimeData (const QModelIndexList &indices) const |
Returns the MIME data for the given indices. More... | |
virtual QModelIndex | mapFromSource (const QModelIndex &index) const |
Returns the model index in the MergeModel given the index from the source model. More... | |
virtual QModelIndex | mapToSource (const QModelIndex &index) const |
Returns the source model index corresponding to the given index from the sorting filter model. More... | |
virtual void | setSourceModel (QAbstractItemModel *) |
void | SetHeaders (const QStringList &headers) |
Sets the new headers for this model. More... | |
void | AddModel (QAbstractItemModel *model) |
Adds a model to the list of source models. More... | |
void | RemoveModel (QAbstractItemModel *model) |
Removes a model from the list of source models. More... | |
size_t | Size () const |
Returns the number of child models in the merger. More... | |
const_iterator | FindModel (const QAbstractItemModel *model) const |
Returns a const_iterator corresponding to the passed model, or one-past-end if no such model is found. More... | |
iterator | FindModel (const QAbstractItemModel *model) |
This is an overloaded function provided for convenience. Non-const and returns a non-const iterator. More... | |
int | GetStartingRow (const_iterator it) const |
Finds starting row for the model pointed by it. More... | |
const_iterator | GetModelForRow (int row, int *starting=0) const |
Returns the model for the given row. More... | |
iterator | GetModelForRow (int row, int *starting=0) |
This is an overloaded function provided for convenience. More... | |
QList< QAbstractItemModel * > | GetAllModels () const |
Returns all models intalled into this one. More... | |
Protected Types | |
typedef QList< QPointer < QAbstractItemModel > > | models_t |
Protected Member Functions | |
virtual bool | AcceptsRow (QAbstractItemModel *model, int row) const |
Allows to filter rows from the resulting model. More... | |
Protected Attributes | |
models_t | Models_ |
Merges data from multiple source models into one resulting model and provides means to lookup models by row, get starting rows for a model etc.
To add a new source model, one should use AddModel() as setSourceModel() throws an std::runtime_error exception.
Currently it doesn't support hierarchical source models. Seems like it would never support it at least someone would try to implement it.
Definition at line 56 of file mergemodel.h.
typedef models_t::const_iterator LeechCraft::Util::MergeModel::const_iterator |
Definition at line 70 of file mergemodel.h.
typedef models_t::iterator LeechCraft::Util::MergeModel::iterator |
Definition at line 69 of file mergemodel.h.
|
protected |
Definition at line 62 of file mergemodel.h.
LeechCraft::Util::MergeModel::MergeModel | ( | const QStringList & | headers, |
QObject * | parent = 0 |
||
) |
Constructs the merge model.
Sets the given headers and parent object.
[in] | headers | The headers of the model. |
[in] | parent | The parent object of the model. |
Definition at line 41 of file mergemodel.cpp.
|
protectedvirtual |
Allows to filter rows from the resulting model.
This virtual function could be overridden to provide custom filtering facilities. If the row in the model should be merged into the resulting model, this function should return true, otherwise if it returns false the row would be filtered out.
[in] | model | The source model the row belongs. |
[in] | row | The row index in the source model. |
Definition at line 511 of file mergemodel.cpp.
void LeechCraft::Util::MergeModel::AddModel | ( | QAbstractItemModel * | model | ) |
Adds a model to the list of source models.
The newly added model is appended to the end.
If the model already exists in the list, it is added again, and bad things would happen, as all the signals and slots would be connected and called twice. So it's your duty to ensure that you don't add the same model more than once.
[in] | model | The model to append to the list. |
Definition at line 230 of file mergemodel.cpp.
References handleColumnsAboutToBeInserted(), handleColumnsAboutToBeRemoved(), handleColumnsInserted(), handleColumnsRemoved(), handleDataChanged(), handleModelAboutToBeReset(), handleModelReset(), handleRowsAboutToBeInserted(), handleRowsAboutToBeRemoved(), handleRowsInserted(), handleRowsRemoved(), Models_, and rowCount().
|
virtual |
Definition at line 49 of file mergemodel.cpp.
References mapToSource().
|
virtual |
Definition at line 68 of file mergemodel.cpp.
References mapToSource().
MergeModel::const_iterator LeechCraft::Util::MergeModel::FindModel | ( | const QAbstractItemModel * | model | ) | const |
Returns a const_iterator corresponding to the passed model, or one-past-end if no such model is found.
[in] | model | The model to find. |
Definition at line 301 of file mergemodel.cpp.
References Models_.
Referenced by GetModelForRow(), handleModelAboutToBeReset(), handleModelReset(), handleRowsAboutToBeInserted(), handleRowsAboutToBeRemoved(), handleRowsInserted(), and RemoveModel().
MergeModel::iterator LeechCraft::Util::MergeModel::FindModel | ( | const QAbstractItemModel * | model | ) |
This is an overloaded function provided for convenience. Non-const and returns a non-const iterator.
[in] | model | The model to find. |
Definition at line 306 of file mergemodel.cpp.
References Models_.
|
virtual |
Definition at line 85 of file mergemodel.cpp.
References mapToSource().
QList< QAbstractItemModel * > LeechCraft::Util::MergeModel::GetAllModels | ( | ) | const |
Returns all models intalled into this one.
Only those models that are not null (and, thus, haven't been destroyed) are returned in the list. This list is guaranteed to contain only valid objects.
Definition at line 369 of file mergemodel.cpp.
References Models_.
Referenced by mimeTypes().
MergeModel::const_iterator LeechCraft::Util::MergeModel::GetModelForRow | ( | int | row, |
int * | starting = 0 |
||
) | const |
Returns the model for the given row.
Returns the model that corresponds to the given row. If there is no such model, throws std::runtime_error. If starting is not null, it also calculates and returns the starting row for the returned model. This allows one to avoid calling GetStartingRow() after this function and thus speed things up.
[in] | row | The row that should be identified. |
[in,out] | starting | The pointer to variable that will store the starting row, if not null. |
std::runtime_error | Throws if there is no model for such row. |
Definition at line 347 of file mergemodel.cpp.
References FindModel(), and GetStartingRow().
MergeModel::iterator LeechCraft::Util::MergeModel::GetModelForRow | ( | int | row, |
int * | starting = 0 |
||
) |
This is an overloaded function provided for convenience.
[in] | row | The row that should be identified. |
[in,out] | starting | The pointer to variable that will store the starting row, if not null. |
std::runtime_error | Throws if there is no model for such row. |
Definition at line 358 of file mergemodel.cpp.
References FindModel(), and GetStartingRow().
int LeechCraft::Util::MergeModel::GetStartingRow | ( | MergeModel::const_iterator | it | ) | const |
Finds starting row for the model pointed by it.
Returns the row in the resulting MergeModel from which do begin rows which belong to the model corresponding to the given const_iterator.
[in] | it | The iterator corresponding to the model. |
Definition at line 339 of file mergemodel.cpp.
References Models_.
Referenced by GetModelForRow(), handleModelAboutToBeReset(), handleModelReset(), handleRowsAboutToBeInserted(), handleRowsAboutToBeRemoved(), and handleRowsInserted().
|
virtualslot |
Definition at line 378 of file mergemodel.cpp.
Referenced by AddModel().
|
virtualslot |
Definition at line 382 of file mergemodel.cpp.
Referenced by AddModel().
|
virtualslot |
Definition at line 388 of file mergemodel.cpp.
Referenced by AddModel().
|
virtualslot |
Definition at line 392 of file mergemodel.cpp.
Referenced by AddModel().
|
virtualslot |
Definition at line 398 of file mergemodel.cpp.
References mapFromSource().
Referenced by AddModel().
|
virtualslot |
Definition at line 483 of file mergemodel.cpp.
References FindModel(), and GetStartingRow().
Referenced by AddModel().
|
virtualslot |
Definition at line 495 of file mergemodel.cpp.
References FindModel(), and GetStartingRow().
Referenced by AddModel().
|
virtualslot |
Definition at line 404 of file mergemodel.cpp.
References FindModel(), GetStartingRow(), and mapFromSource().
Referenced by AddModel().
|
virtualslot |
Definition at line 416 of file mergemodel.cpp.
References FindModel(), GetStartingRow(), and mapFromSource().
Referenced by AddModel().
|
virtualslot |
Definition at line 444 of file mergemodel.cpp.
References FindModel(), GetStartingRow(), and mapFromSource().
Referenced by AddModel().
|
virtualslot |
Definition at line 478 of file mergemodel.cpp.
Referenced by AddModel().
|
virtual |
Definition at line 60 of file mergemodel.cpp.
|
virtual |
Definition at line 99 of file mergemodel.cpp.
Referenced by mimeData().
|
virtual |
Returns the model index in the MergeModel given the index from the source model.
[in] | index | Source index. |
Definition at line 180 of file mergemodel.cpp.
References parent().
Referenced by handleDataChanged(), handleRowsAboutToBeInserted(), handleRowsAboutToBeRemoved(), and handleRowsInserted().
|
virtual |
Returns the source model index corresponding to the given index from the sorting filter model.
[in] | index | MergeModel's index. |
Definition at line 210 of file mergemodel.cpp.
Referenced by columnCount(), data(), flags(), and mimeData().
QMimeData * LeechCraft::Util::MergeModel::mimeData | ( | const QModelIndexList & | indices | ) | const |
Returns the MIME data for the given indices.
This function queries the corresponding source model for each index of the indices, merging the URL list (if any) and using first obtained data of any other format.
[in] | indices | The indices for which to return the MIME data. |
Definition at line 155 of file mergemodel.cpp.
References index(), and mapToSource().
QStringList LeechCraft::Util::MergeModel::mimeTypes | ( | ) | const |
Returns the union of MIME types of the models.
Definition at line 133 of file mergemodel.cpp.
References GetAllModels().
|
virtual |
Definition at line 111 of file mergemodel.cpp.
Referenced by mapFromSource().
void LeechCraft::Util::MergeModel::RemoveModel | ( | QAbstractItemModel * | model | ) |
Removes a model from the list of source models.
If there is no such model, this function does nothing.
[in] | model | The model to remove from the list. |
Definition at line 311 of file mergemodel.cpp.
References FindModel(), and Models_.
|
virtual |
Definition at line 124 of file mergemodel.cpp.
References LeechCraft::Util::ModelItem::GetModel().
Referenced by AddModel().
void LeechCraft::Util::MergeModel::SetHeaders | ( | const QStringList & | headers | ) |
Sets the new headers for this model.
[in] | headers | The new headers. |
Definition at line 225 of file mergemodel.cpp.
|
virtual |
You shouldn't use this function because its semantics in the context of multiple source models aren't clearly defined. Calling this function results in std::runtime_error.
std::runtime_error | No matter what, you'd get it. |
Definition at line 220 of file mergemodel.cpp.
size_t LeechCraft::Util::MergeModel::Size | ( | ) | const |
Returns the number of child models in the merger.
Definition at line 334 of file mergemodel.cpp.
References Models_.
|
protected |
Definition at line 63 of file mergemodel.h.
Referenced by AddModel(), FindModel(), GetAllModels(), GetStartingRow(), RemoveModel(), and Size().