#include <selectionproxymodel.h>

Public Member Functions | |
SelectionProxyModel (QItemSelectionModel *selectionModel, QObject *parent=0) |
Detailed Description
A proxy model used to reference count selected Akonadi::Collection in a view.
Only selected Collections will be populated and monitored for changes. Unselected Collections will be ignored.
This model extends KSelectionProxyModel to implement reference counting on the Collections in an EntityTreeModel. The EntityTreeModel must use LazyPopulation to enable SelectionProxyModel to work.
By selecting a Collection, its reference count will be increased. A Collection in the EntityTreeModel which has a reference count of zero will ignore all signals from Monitor about items changed, inserted, removed etc, which can be expensive operations.
Example:
using namespace Akonadi; // itemView // ^ // | // itemModel // | // flatModel // | // collectionView --> selectionModel // ^ ^ // | | // collectionFilter | // \______________model EntityTreeModel *model = new EntityTreeModel( ... ); // setup collection model EntityMimeTypeFilterModel *collectionFilter = new EntityMimeTypeFilterModel( this ); collectionFilter->setSourceModel( model ); collectionFilter->addMimeTypeInclusionFilter( Collection::mimeType() ); collectionFilter->setHeaderGroup( EntityTreeModel::CollectionTreeHeaders ); // setup collection view EntityTreeView *collectionView = new EntityTreeView( this ); collectionView->setModel( collectionFilter ); // setup selection model SelectionProxyModel *selectionModel = new SelectionProxyModel( collectionView->selectionModel(), this ); selectionModel->setSourceModel( model ); // setup item model KDescendantsProxyModel *flatModel = new KDescendantsProxyModel( this ); flatModel->setSourceModel( selectionModel ); EntityMimeTypeFilterModel *itemModel = new EntityMimeTypeFilterModel( this ); itemModel->setSourceModel( flatModel ); itemModel->setHeaderGroup( EntityTreeModel::ItemListHeaders ); itemModel->addMimeTypeExclusionFilter( Collection::mimeType() ); EntityListView *itemView = new EntityListView( this ); itemView->setModel( itemModel );
See Integration in your Application for further guidance on the use of this class.
- Since:
- 4.4
Constructor & Destructor Documentation
SelectionProxyModel::SelectionProxyModel | ( | QItemSelectionModel * | selectionModel, |
QObject * | parent = 0 |
||
) | [explicit] |
Creates a new selection proxy model.
- Parameters:
-
selectionModel The selection model of the source view. parent The parent object.
Definition at line 68 of file selectionproxymodel.cpp.
The documentation for this class was generated from the following files: