就業培訓     下載中心     Wiki     聯絡
登錄   注冊
  1. 首頁
  2. Qt 6.10.1
  3. Qt Core
  4. C++ 類
  5. QAbstractProxyModel

QAbstractProxyModel 類

QAbstractProxyModel 類為代理項模型提供可以履行排序、過濾或其它數據處理任務的基類。 更多...

頭： #include <QAbstractProxyModel>
CMake: find_package(Qt6 REQUIRED COMPONENTS Core)
target_link_libraries(mytarget PRIVATE Qt6::Core)
qmake: QT += core
繼承： QAbstractItemModel
繼承者：

QIdentityProxyModel , QSortFilterProxyModel ，和 QTransposeProxyModel

特性

公共函數

QAbstractProxyModel (QObject * parent = nullptr)
virtual ~QAbstractProxyModel ()
QBindable<QAbstractItemModel *> bindableSourceModel ()
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

重實現公共函數

virtual QModelIndex buddy (const QModelIndex & index ) const override
virtual bool canDropMimeData (const QMimeData * data , Qt::DropAction action , int row , int column , const QModelIndex & parent ) const override
virtual bool canFetchMore (const QModelIndex & parent ) const override
(從 6.0 起) virtual bool clearItemData (const QModelIndex & index ) override
virtual QVariant data (const QModelIndex & proxyIndex , int role = Qt::DisplayRole) const override
virtual bool dropMimeData (const QMimeData * data , Qt::DropAction action , int row , int column , const QModelIndex & parent ) override
virtual void fetchMore (const QModelIndex & parent ) override
virtual Qt::ItemFlags flags (const QModelIndex & index ) const override
virtual bool hasChildren (const QModelIndex & parent = QModelIndex()) const override
virtual QVariant headerData (int section , Qt::Orientation orientation , int role = Qt::DisplayRole) const override
virtual QMap<int, QVariant> itemData (const QModelIndex & proxyIndex ) const override
virtual QMimeData * mimeData (const QModelIndexList & indexes ) const override
virtual QStringList mimeTypes () const override
virtual void revert () override
virtual QHash<int, QByteArray> roleNames () const override
virtual bool setData (const QModelIndex & index , const QVariant & value , int role = Qt::EditRole) override
virtual bool setHeaderData (int section , Qt::Orientation orientation , const QVariant & value , int role = Qt::EditRole) override
virtual bool setItemData (const QModelIndex & index , const QMap<int, QVariant> & roles ) override
virtual QModelIndex sibling (int row , int column , const QModelIndex & idx ) const override
virtual void sort (int column , Qt::SortOrder order = Qt::AscendingOrder) override
virtual QSize span (const QModelIndex & index ) const override
virtual bool submit () override
virtual Qt::DropActions supportedDragActions () const override
virtual Qt::DropActions supportedDropActions () const override

信號

void sourceModelChanged ()

保護函數

(從 6.2 起) QModelIndex createSourceIndex (int row , int col , void * internalPtr ) const

詳細描述

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 () 和 mapToSource ()。 mapSelectionFromSource () 和 mapSelectionToSource () functions only need to be reimplemented if you need a behavior different from the default behavior.

注意： If the source model is deleted or no source model is specified, the proxy model operates on a empty placeholder model.

另請參閱 QSortFilterProxyModel , QAbstractItemModel ，和 模型/視圖編程 .

特性文檔編製

[bindable] sourceModel : QAbstractItemModel *

注意： 此特性支持 QProperty 綁定。

此特性保持此代理模型的源模型。

訪問函數：

QAbstractItemModel * sourceModel () const
virtual void setSourceModel (QAbstractItemModel * sourceModel )

通知程序信號：

void sourceModelChanged () [見下文注意事項]

注意： 這是私有信號。它可以用於信號連接，但不能由用戶發射。

成員函數文檔編製

[explicit] QAbstractProxyModel:: QAbstractProxyModel ( QObject * parent = nullptr)

Constructs a proxy model with the given parent .

[virtual noexcept] QAbstractProxyModel:: ~QAbstractProxyModel ()

Destroys the proxy model.

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

重實現： QAbstractItemModel::buddy (const QModelIndex &index) const.

[override virtual] bool QAbstractProxyModel:: canDropMimeData (const QMimeData * data , Qt::DropAction action , int row , int column , const QModelIndex & parent ) const

重實現： QAbstractItemModel::canDropMimeData (const QMimeData *data, Qt::DropAction action, int row, int column, const QModelIndex &parent) const.

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

重實現： QAbstractItemModel::canFetchMore (const QModelIndex &parent) const.

[override virtual, since 6.0] bool QAbstractProxyModel:: clearItemData (const QModelIndex & index )

重實現： QAbstractItemModel::clearItemData (const QModelIndex &index).

該函數在 Qt 6.0 引入。

[protected, since 6.2] QModelIndex QAbstractProxyModel:: createSourceIndex ( int row , int col , void * internalPtr ) const

Equivalent to calling createIndex on the source model.

This method is useful if your proxy model wants to maintain the parent-child relationship of items in the source model. When reimplementing mapToSource (), you can call this method to create an index for row row and column col of the source model.

A typical use would be to save the internal pointer coming from the source model in the proxy index when reimplementing mapFromSource () and use the same internal pointer as internalPtr to recover the original source index when reimplementing mapToSource ().

該函數在 Qt 6.2 引入。

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

重實現： QAbstractItemModel::data (const QModelIndex &index, int role) const.

另請參閱 setData ().

[override virtual] bool QAbstractProxyModel:: dropMimeData (const QMimeData * data , Qt::DropAction action , int row , int column , const QModelIndex & parent )

重實現： QAbstractItemModel::dropMimeData (const QMimeData *data, Qt::DropAction action, int row, int column, const QModelIndex &parent).

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

重實現： QAbstractItemModel::fetchMore (const QModelIndex &parent).

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

重實現： QAbstractItemModel::flags (const QModelIndex &index) const.

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

重實現： QAbstractItemModel::hasChildren (const QModelIndex &parent) const.

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

重實現： QAbstractItemModel::headerData (int section, Qt::Orientation orientation, int role) const.

另請參閱 setHeaderData ().

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

重實現： QAbstractItemModel::itemData (const QModelIndex &index) const.

另請參閱 setItemData ().

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

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

注意： 此函數可以被援引，通過元對象係統和從 QML。見 Q_INVOKABLE .

另請參閱 mapToSource ().

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

Returns a proxy selection mapped from the specified sourceSelection .

Reimplement this method to map source selections to proxy selections.

注意： 此函數可以被援引，通過元對象係統和從 QML。見 Q_INVOKABLE .

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

Returns a source selection mapped from the specified proxySelection .

Reimplement this method to map proxy selections to source selections.

注意： 此函數可以被援引，通過元對象係統和從 QML。見 Q_INVOKABLE .

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

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

注意： 此函數可以被援引，通過元對象係統和從 QML。見 Q_INVOKABLE .

另請參閱 mapFromSource ().

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

重實現： QAbstractItemModel::mimeData (const QModelIndexList &indexes) const.

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

重實現： QAbstractItemModel::mimeTypes () const.

[override virtual] void QAbstractProxyModel:: revert ()

重實現： QAbstractItemModel::revert ().

[override virtual] QHash < int , QByteArray > QAbstractProxyModel:: roleNames () const

重實現： QAbstractItemModel::roleNames () const.

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

重實現： QAbstractItemModel::setData (const QModelIndex &index, const QVariant &value, int role).

另請參閱 data ().

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

重實現： QAbstractItemModel::setHeaderData (int section, Qt::Orientation orientation, const QVariant &value, int role).

另請參閱 headerData ().

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

重實現： QAbstractItemModel::setItemData (const QModelIndex &index, const QMap<int, QVariant> &roles).

另請參閱 itemData ().

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

設置給定 sourceModel to be processed by the proxy model.

Subclasses should call beginResetModel () at the beginning of the method, disconnect from the old model, call this method, connect to the new model, and call endResetModel ().

注意： setter 函數對於特性 sourceModel .

另請參閱 sourceModel ().

[override virtual] QModelIndex QAbstractProxyModel:: sibling ( int row , int column , const QModelIndex & idx ) const

重實現： QAbstractItemModel::sibling (int row, int column, const QModelIndex &index) const.

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

重實現： QAbstractItemModel::sort (int column, Qt::SortOrder order).

QAbstractItemModel *QAbstractProxyModel:: sourceModel () const

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

注意： Getter function for property sourceModel.

另請參閱 setSourceModel ().

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

重實現： QAbstractItemModel::span (const QModelIndex &index) const.

[override virtual] bool QAbstractProxyModel:: submit ()

重實現： QAbstractItemModel::submit ().

[override virtual] Qt::DropActions QAbstractProxyModel:: supportedDragActions () const

重實現： QAbstractItemModel::supportedDragActions () const.

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

重實現： QAbstractItemModel::supportedDropActions () const.

內容

  1. 特性

  2. 公共函數

  3. 重實現公共函數

  4. 信號

  5. 保護函數

  6. 詳細描述