QAbstractProxyModel Class Reference

The QAbstractProxyModel class provides a base class for proxy item models that can do sorting, filtering or other data processing tasks. More...

 #include <QAbstractProxyModel>

Inherits: QAbstractItemModel.

Inherited by: QIdentityProxyModel and QSortFilterProxyModel.

This class was introduced in Qt 4.1.

List of all members, including inherited members

Public Functions

	QAbstractProxyModel ( QObject * parent = 0 )
	~QAbstractProxyModel ()
virtual QModelIndex	mapFromSource ( const QModelIndex & sourceIndex ) const = 0
virtual QItemSelection	mapSelectionFromSource ( const QItemSelection & sourceSelection ) const
virtual QItemSelection	mapSelectionToSource ( const QItemSelection & proxySelection ) const
virtual QModelIndex	mapToSource ( const QModelIndex & proxyIndex ) const = 0
virtual void	setSourceModel ( QAbstractItemModel * sourceModel )
QAbstractItemModel *	sourceModel () const

Reimplemented Public Functions

virtual QModelIndex	buddy ( const QModelIndex & index ) const
virtual bool	canFetchMore ( const QModelIndex & parent ) const
virtual QVariant	data ( const QModelIndex & proxyIndex, int role = Qt::DisplayRole ) const
virtual void	fetchMore ( const QModelIndex & parent )
virtual Qt::ItemFlags	flags ( const QModelIndex & index ) const
virtual bool	hasChildren ( const QModelIndex & parent = QModelIndex() ) const
virtual QVariant	headerData ( int section, Qt::Orientation orientation, int role ) const
virtual QMap<int, QVariant>	itemData ( const QModelIndex & proxyIndex ) const
virtual QMimeData *	mimeData ( const QModelIndexList & indexes ) const
virtual QStringList	mimeTypes () const
virtual void	revert ()
virtual bool	setData ( const QModelIndex & index, const QVariant & value, int role = Qt::EditRole )
virtual bool	setHeaderData ( int section, Qt::Orientation orientation, const QVariant & value, int role = Qt::EditRole )
virtual bool	setItemData ( const QModelIndex & index, const QMap<int, QVariant> & roles )
virtual void	sort ( int column, Qt::SortOrder order = Qt::AscendingOrder )
virtual QSize	span ( const QModelIndex & index ) const
virtual bool	submit ()
virtual Qt::DropActions	supportedDropActions () const

35 public functions inherited from QAbstractItemModel
29 public functions inherited from QObject

Additional Inherited Members

1 property inherited from QObject
2 public slots inherited from QAbstractItemModel
1 public slot inherited from QObject
18 signals inherited from QAbstractItemModel
1 signal inherited from QObject
7 static public members inherited from QObject
21 protected functions inherited from QAbstractItemModel
8 protected functions inherited from QObject
1 protected slot inherited from QAbstractItemModel

Detailed Description

The QAbstractProxyModel class provides a base class for proxy item models that can do sorting, filtering or other data processing tasks.

This class defines the standard interface that proxy models must use to be able to interoperate correctly with other model/view components. It is not supposed to be instantiated directly.

All standard proxy models are derived from the QAbstractProxyModel class. If you need to create a new proxy model class, it is usually better to subclass an existing class that provides the closest behavior to the one you want to provide.

Proxy models that filter or sort items of data from a source model should be created by using or subclassing QSortFilterProxyModel.

To subclass QAbstractProxyModel, you need to implement mapFromSource() and mapToSource(). The mapSelectionFromSource() and mapSelectionToSource() functions only need to be reimplemented if you need a behavior different from the default behavior.

Note: If the source model is deleted or no source model is specified, the proxy model operates on a empty placeholder model.

Member Function Documentation

QAbstractProxyModel::QAbstractProxyModel ( QObject * parent = 0 )

Constructs a proxy model with the given parent.

QAbstractProxyModel::~QAbstractProxyModel ()

Destroys the proxy model.

QModelIndex QAbstractProxyModel::buddy ( const QModelIndex & index ) const `[virtual]`

Reimplemented from QAbstractItemModel::buddy().

This function was introduced in Qt 4.8.

bool QAbstractProxyModel::canFetchMore ( const QModelIndex & parent ) const `[virtual]`

Reimplemented from QAbstractItemModel::canFetchMore().

This function was introduced in Qt 4.8.

QVariant QAbstractProxyModel::data ( const QModelIndex & proxyIndex, int role = Qt::DisplayRole ) const `[virtual]`

Reimplemented from QAbstractItemModel::data().

See also setData().

void QAbstractProxyModel::fetchMore ( const QModelIndex & parent ) `[virtual]`

Reimplemented from QAbstractItemModel::fetchMore().

This function was introduced in Qt 4.8.

Qt::ItemFlags QAbstractProxyModel::flags ( const QModelIndex & index ) const `[virtual]`

Reimplemented from QAbstractItemModel::flags().

bool QAbstractProxyModel::hasChildren ( const QModelIndex & parent = QModelIndex() ) const `[virtual]`

Reimplemented from QAbstractItemModel::hasChildren().

This function was introduced in Qt 4.8.

QVariant QAbstractProxyModel::headerData ( int section, Qt::Orientation orientation, int role ) const `[virtual]`

Reimplemented from QAbstractItemModel::headerData().

See also setHeaderData().

QMap<int, QVariant> QAbstractProxyModel::itemData ( const QModelIndex & proxyIndex ) const `[virtual]`

Reimplemented from QAbstractItemModel::itemData().

See also setItemData().

QModelIndex QAbstractProxyModel::mapFromSource ( const QModelIndex & sourceIndex ) const `[pure virtual]`

Reimplement this function to return the model index in the proxy model that corresponds to the sourceIndex from the source model.

See also mapToSource().

QItemSelection QAbstractProxyModel::mapSelectionFromSource ( const QItemSelection & sourceSelection ) const `[virtual]`

Returns a proxy selection mapped from the specified sourceSelection.

Reimplement this method to map source selections to proxy selections.

QItemSelection QAbstractProxyModel::mapSelectionToSource ( const QItemSelection & proxySelection ) const `[virtual]`

Returns a source selection mapped from the specified proxySelection.

Reimplement this method to map proxy selections to source selections.

QModelIndex QAbstractProxyModel::mapToSource ( const QModelIndex & proxyIndex ) const `[pure virtual]`

Reimplement this function to return the model index in the source model that corresponds to the proxyIndex in the proxy model.

See also mapFromSource().

QMimeData * QAbstractProxyModel::mimeData ( const QModelIndexList & indexes ) const `[virtual]`

Reimplemented from QAbstractItemModel::mimeData().

This function was introduced in Qt 4.8.

QStringList QAbstractProxyModel::mimeTypes () const `[virtual]`

Reimplemented from QAbstractItemModel::mimeTypes().

This function was introduced in Qt 4.8.

void QAbstractProxyModel::revert () `[virtual]`

Reimplemented from QAbstractItemModel::revert().

bool QAbstractProxyModel::setData ( const QModelIndex & index, const QVariant & value, int role = Qt::EditRole ) `[virtual]`

Reimplemented from QAbstractItemModel::setData().

See also data().

bool QAbstractProxyModel::setHeaderData ( int section, Qt::Orientation orientation, const QVariant & value, int role = Qt::EditRole ) `[virtual]`

Reimplemented from QAbstractItemModel::setHeaderData().

See also headerData().

bool QAbstractProxyModel::setItemData ( const QModelIndex & index, const QMap<int, QVariant> & roles ) `[virtual]`

Reimplemented from QAbstractItemModel::setItemData().

See also itemData().

void QAbstractProxyModel::setSourceModel ( QAbstractItemModel * sourceModel ) `[virtual]`

Sets the given sourceModel to be processed by the proxy model.

See also sourceModel().

void QAbstractProxyModel::sort ( int column, Qt::SortOrder order = Qt::AscendingOrder ) `[virtual]`

Reimplemented from QAbstractItemModel::sort().

This function was introduced in Qt 4.8.

QAbstractItemModel * QAbstractProxyModel::sourceModel () const

Returns the model that contains the data that is available through the proxy model.

See also setSourceModel().

QSize QAbstractProxyModel::span ( const QModelIndex & index ) const `[virtual]`

Reimplemented from QAbstractItemModel::span().

This function was introduced in Qt 4.8.

bool QAbstractProxyModel::submit () `[virtual]`

Reimplemented from QAbstractItemModel::submit().

Qt::DropActions QAbstractProxyModel::supportedDropActions () const `[virtual]`

Reimplemented from QAbstractItemModel::supportedDropActions().

This function was introduced in Qt 4.8.

Contents

QAbstractProxyModel Class Reference

Public Functions

Reimplemented Public Functions

Additional Inherited Members

Detailed Description

Member Function Documentation

QAbstractProxyModel::QAbstractProxyModel ( QObject * parent = 0 )

QAbstractProxyModel::~QAbstractProxyModel ()

QModelIndex QAbstractProxyModel::buddy ( const QModelIndex & index ) const [virtual]

bool QAbstractProxyModel::canFetchMore ( const QModelIndex & parent ) const [virtual]

QVariant QAbstractProxyModel::data ( const QModelIndex & proxyIndex, int role = Qt::DisplayRole ) const [virtual]

void QAbstractProxyModel::fetchMore ( const QModelIndex & parent ) [virtual]

Qt::ItemFlags QAbstractProxyModel::flags ( const QModelIndex & index ) const [virtual]

bool QAbstractProxyModel::hasChildren ( const QModelIndex & parent = QModelIndex() ) const [virtual]

QVariant QAbstractProxyModel::headerData ( int section, Qt::Orientation orientation, int role ) const [virtual]

QMap<int, QVariant> QAbstractProxyModel::itemData ( const QModelIndex & proxyIndex ) const [virtual]

QModelIndex QAbstractProxyModel::mapFromSource ( const QModelIndex & sourceIndex ) const [pure virtual]

QItemSelection QAbstractProxyModel::mapSelectionFromSource ( const QItemSelection & sourceSelection ) const [virtual]

QItemSelection QAbstractProxyModel::mapSelectionToSource ( const QItemSelection & proxySelection ) const [virtual]

QModelIndex QAbstractProxyModel::mapToSource ( const QModelIndex & proxyIndex ) const [pure virtual]

QMimeData * QAbstractProxyModel::mimeData ( const QModelIndexList & indexes ) const [virtual]

QStringList QAbstractProxyModel::mimeTypes () const [virtual]

void QAbstractProxyModel::revert () [virtual]

bool QAbstractProxyModel::setData ( const QModelIndex & index, const QVariant & value, int role = Qt::EditRole ) [virtual]

bool QAbstractProxyModel::setHeaderData ( int section, Qt::Orientation orientation, const QVariant & value, int role = Qt::EditRole ) [virtual]

bool QAbstractProxyModel::setItemData ( const QModelIndex & index, const QMap<int, QVariant> & roles ) [virtual]

void QAbstractProxyModel::setSourceModel ( QAbstractItemModel * sourceModel ) [virtual]

void QAbstractProxyModel::sort ( int column, Qt::SortOrder order = Qt::AscendingOrder ) [virtual]

QAbstractItemModel * QAbstractProxyModel::sourceModel () const

QSize QAbstractProxyModel::span ( const QModelIndex & index ) const [virtual]

bool QAbstractProxyModel::submit () [virtual]

Qt::DropActions QAbstractProxyModel::supportedDropActions () const [virtual]

QModelIndex QAbstractProxyModel::buddy ( const QModelIndex & index ) const `[virtual]`

bool QAbstractProxyModel::canFetchMore ( const QModelIndex & parent ) const `[virtual]`

QVariant QAbstractProxyModel::data ( const QModelIndex & proxyIndex, int role = Qt::DisplayRole ) const `[virtual]`

void QAbstractProxyModel::fetchMore ( const QModelIndex & parent ) `[virtual]`

Qt::ItemFlags QAbstractProxyModel::flags ( const QModelIndex & index ) const `[virtual]`

bool QAbstractProxyModel::hasChildren ( const QModelIndex & parent = QModelIndex() ) const `[virtual]`

QVariant QAbstractProxyModel::headerData ( int section, Qt::Orientation orientation, int role ) const `[virtual]`

QMap<int, QVariant> QAbstractProxyModel::itemData ( const QModelIndex & proxyIndex ) const `[virtual]`

QModelIndex QAbstractProxyModel::mapFromSource ( const QModelIndex & sourceIndex ) const `[pure virtual]`

QItemSelection QAbstractProxyModel::mapSelectionFromSource ( const QItemSelection & sourceSelection ) const `[virtual]`

QItemSelection QAbstractProxyModel::mapSelectionToSource ( const QItemSelection & proxySelection ) const `[virtual]`

QModelIndex QAbstractProxyModel::mapToSource ( const QModelIndex & proxyIndex ) const `[pure virtual]`

QMimeData * QAbstractProxyModel::mimeData ( const QModelIndexList & indexes ) const `[virtual]`

QStringList QAbstractProxyModel::mimeTypes () const `[virtual]`

void QAbstractProxyModel::revert () `[virtual]`

bool QAbstractProxyModel::setData ( const QModelIndex & index, const QVariant & value, int role = Qt::EditRole ) `[virtual]`

bool QAbstractProxyModel::setHeaderData ( int section, Qt::Orientation orientation, const QVariant & value, int role = Qt::EditRole ) `[virtual]`

bool QAbstractProxyModel::setItemData ( const QModelIndex & index, const QMap<int, QVariant> & roles ) `[virtual]`

void QAbstractProxyModel::setSourceModel ( QAbstractItemModel * sourceModel ) `[virtual]`

void QAbstractProxyModel::sort ( int column, Qt::SortOrder order = Qt::AscendingOrder ) `[virtual]`

QSize QAbstractProxyModel::span ( const QModelIndex & index ) const `[virtual]`

bool QAbstractProxyModel::submit () `[virtual]`

Qt::DropActions QAbstractProxyModel::supportedDropActions () const `[virtual]`