内容

• 公共函数
• 重实现公共函数
• 详细描述

QProxyModel Class

The QProxyModel class provides support for processing data passed between another model and a view. 更多...

头：	#include <QProxyModel>
继承：	QAbstractItemModel

该类已过时。 提供它是为使旧源代码能继续工作。强烈建议不要在新代码中使用它。

• 所有成员列表，包括继承成员

公共函数

	QProxyModel (QObject * parent = 0)
	~QProxyModel ()
QAbstractItemModel *	model () const
virtual void	setModel (QAbstractItemModel * model )

重实现公共函数

virtual int	columnCount (const QModelIndex & parent = QModelIndex()) const
virtual QVariant	data (const QModelIndex & index , int role = Qt::DisplayRole) const
virtual bool	dropMimeData (const QMimeData * data , Qt::DropAction action , int row , int column , const QModelIndex & parent )
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 = Qt::DisplayRole) const
virtual QModelIndex	index (int row , int column , const QModelIndex & parent = QModelIndex()) const
virtual bool	insertColumns (int column , int count , const QModelIndex & parent = QModelIndex())
virtual bool	insertRows (int row , int count , const QModelIndex & parent = QModelIndex())
virtual QModelIndexList	match (const QModelIndex & start , int role , const QVariant & value , int hits = 1, Qt::MatchFlags flags = Qt::MatchFlags( Qt::MatchStartsWith | Qt::MatchWrap )) const
virtual QMimeData *	mimeData (const QModelIndexList & indexes ) const
virtual QStringList	mimeTypes () const
virtual QModelIndex	parent (const QModelIndex & child ) const
virtual void	revert ()
virtual int	rowCount (const QModelIndex & parent = QModelIndex()) const
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 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 公共函数继承自 QAbstractItemModel
• 29 公共函数继承自 QObject

额外继承成员

• 1 特性继承自 QObject
• 2 公共槽继承自 QAbstractItemModel
• 1 公共槽继承自 QObject
• 18 信号继承自 QAbstractItemModel
• 1 信号继承自 QObject
• 7 静态公共成员继承自 QObject
• 21 protected functions inherited from QAbstractItemModel
• 8 保护函数继承自 QObject
• 1 保护槽继承自 QAbstractItemModel

详细描述

The QProxyModel class provides support for processing data passed between another model and a view.

If you want to do filtering and sorting, see QSortFilterProxyModel .

Proxy models provide a standard model interface that can be used to manipulate the data retrieved through an underlying model. They can be used to perform operations such as sorting and filtering on the data obtained without changing the contents of the model.

Just as with subclasses of QAbstractItemView , QProxyModel 提供 setModel () function that is used to specify the model to be acted on by the proxy. Views can be connected to either the underlying model or the proxy model with QAbstractItemView::setModel ().

Since views rely on the information provided in model indexes to identify items of data from models, and to position these items in some visual representation, proxy models must create their own model indexes instead of supplying model indexes from their underlying models.

另请参阅 模型/视图编程 and QAbstractItemModel .

成员函数文档编制

QProxyModel:: QProxyModel ( QObject * parent = 0)

Constructs a proxy model with the given parent .

QProxyModel:: ~QProxyModel ()

Destroys the proxy model.

[虚拟] int QProxyModel:: columnCount (const QModelIndex & parent = QModelIndex()) const

重实现自 QAbstractItemModel::columnCount ().

Returns the number of columns for the given parent .

另请参阅 QAbstractItemModel::columnCount ().

[虚拟] QVariant QProxyModel:: data (const QModelIndex & index , int role = Qt::DisplayRole) const

重实现自 QAbstractItemModel::data ().

Returns the data stored in the item with the given index under the specified role .

另请参阅 setData ().

[虚拟] bool QProxyModel:: dropMimeData (const QMimeData * data , Qt::DropAction action , int row , int column , const QModelIndex & parent )

重实现自 QAbstractItemModel::dropMimeData ().

Returns true if the model accepts the data dropped onto an attached view for the specified action ；否则返回 false。

The parent , row ，和 column details can be used to control which MIME types are acceptable to different parts of a model when received via the drag and drop system.

[虚拟] void QProxyModel:: fetchMore (const QModelIndex & parent )

重实现自 QAbstractItemModel::fetchMore ().

Fetches more child items of the given parent . This function is used by views to tell the model that they can display more data than the model has provided.

另请参阅 QAbstractItemModel::fetchMore ().

[虚拟] Qt::ItemFlags QProxyModel:: flags (const QModelIndex & index ) const

重实现自 QAbstractItemModel::flags ().

返回项标志为给定 index .

[虚拟] bool QProxyModel:: hasChildren (const QModelIndex & parent = QModelIndex()) const

重实现自 QAbstractItemModel::hasChildren ().

Returns true if the item corresponding to the parent index has child items; otherwise returns false.

另请参阅 QAbstractItemModel::hasChildren ().

[虚拟] QVariant QProxyModel:: headerData ( int section , Qt::Orientation orientation , int role = Qt::DisplayRole) const

重实现自 QAbstractItemModel::headerData ().

Returns the data stored in the section of the header with specified orientation under the given role .

另请参阅 setHeaderData ().

[虚拟] QModelIndex QProxyModel:: index ( int row , int column , const QModelIndex & parent = QModelIndex()) const

重实现自 QAbstractItemModel::index ().

Returns the model index with the given row , column ，和 parent .

另请参阅 QAbstractItemModel::index ().

[虚拟] bool QProxyModel:: insertColumns ( int column , int count , const QModelIndex & parent = QModelIndex())

重实现自 QAbstractItemModel::insertColumns ().

插入 count columns into the model, creating new items as children of the given parent . The new columns are inserted before the column specified. If the parent item has no children, a single row is created to contain the required number of columns.

Returns true if the columns were successfully inserted; otherwise returns false.

另请参阅 QAbstractItemModel::insertColumns ().

[虚拟] bool QProxyModel:: insertRows ( int row , int count , const QModelIndex & parent = QModelIndex())

重实现自 QAbstractItemModel::insertRows ().

插入 count rows into the model, creating new items as children of the given parent . The new rows are inserted before the row specified. If the parent item has no children, a single column is created to contain the required number of rows.

Returns true if the rows were successfully inserted; otherwise returns false.

另请参阅 QAbstractItemModel::insertRows ().

[虚拟] QModelIndexList QProxyModel:: match (const QModelIndex & start , int role , const QVariant & value , int hits = 1, Qt::MatchFlags flags = Qt::MatchFlags( Qt::MatchStartsWith | Qt::MatchWrap )) const

重实现自 QAbstractItemModel::match ().

Returns a list of model indexes that each contain the given value 为 role specified. The search begins at the start index and is performed according to the specified flags . The search continues until the number of matching data items equals hits , the last row is reached, or the search reaches start again, depending on whether MatchWrap 指定在 flags .

另请参阅 QAbstractItemModel::match ().

[虚拟] QMimeData * QProxyModel:: mimeData (const QModelIndexList & indexes ) const

重实现自 QAbstractItemModel::mimeData ().

Returns MIME data for the specified indexes in the model.

[虚拟] QStringList QProxyModel:: mimeTypes () const

重实现自 QAbstractItemModel::mimeTypes ().

Returns a list of MIME types that are supported by the model.

QAbstractItemModel * QProxyModel:: model () const

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

另请参阅 setModel ().

[虚拟] QModelIndex QProxyModel:: parent (const QModelIndex & child ) const

重实现自 QAbstractItemModel::parent ().

Returns the model index that corresponds to the parent of the given child 索引。

[虚拟] void QProxyModel:: revert ()

重实现自 QAbstractItemModel::revert ().

[虚拟] int QProxyModel:: rowCount (const QModelIndex & parent = QModelIndex()) const

重实现自 QAbstractItemModel::rowCount ().

Returns the number of rows for the given parent .

另请参阅 QAbstractItemModel::rowCount ().

[虚拟] bool QProxyModel:: setData (const QModelIndex & index , const QVariant & value , int role = Qt::EditRole)

重实现自 QAbstractItemModel::setData ().

设置 role 数据为项在 index to value . Returns true if successful; otherwise returns false.

The base class implementation returns false. This function and data () 必须被重实现为可编辑模型。

另请参阅 data (), itemData ()，和 QAbstractItemModel::setData ().

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

重实现自 QAbstractItemModel::setHeaderData ().

设置 role data in the section of the header with the specified orientation 到 value 给定。

另请参阅 headerData () 和 QAbstractItemModel::setHeaderData ().

[虚拟] void QProxyModel:: setModel ( QAbstractItemModel * model )

设置给定 model to be processed by the proxy model.

另请参阅 model ().

[虚拟] void QProxyModel:: sort ( int column , Qt::SortOrder order = Qt::AscendingOrder)

重实现自 QAbstractItemModel::sort ().

Sorts the child items in the specified column according to the sort order defined by order .

另请参阅 QAbstractItemModel::sort ().

[虚拟] QSize QProxyModel:: span (const QModelIndex & index ) const

重实现自 QAbstractItemModel::span ().

Returns the size of the item that corresponds to the specified index .

[虚拟] bool QProxyModel:: submit ()

重实现自 QAbstractItemModel::submit ().

[虚拟] Qt::DropActions QProxyModel:: supportedDropActions () const

重实现自 QAbstractItemModel::supportedDropActions ().

Returns the drop actions that are supported by the model; this is a combination of the individual actions defined in Qt::DropActions .

The selection of drop actions provided by the model will influence the behavior of the component that started the drag and drop operation.

另请参阅 拖放 .