QSortFilterProxyModel的作用和使用方法

原创已于 2024-08-27 11:00:10 修改 · 1.2k 阅读

7 ·

本内容遵循CC 4.0 BY-SA版权协议

标签

#c++

于 2024-08-27 10:59:17 首次发布

QT 专栏收录该内容

1 篇文章

订阅专栏

在Qt中，QSortFilterProxyModel类是一个强大的工具，用于在模型（model）和视图（view）之间提供排序和过滤的支持。它允许开发者对源模型（source model）的数据进行排序和过滤，而无需修改源模型本身。以下是QSortFilterProxyModel的作用和使用方法的详细解析：

作用
排序：QSortFilterProxyModel可以根据指定的排序规则对源模型的数据进行排序，支持升序和降序等多种排序方式。
过滤：它还可以根据正则表达式、通配符或固定字符串等过滤规则对源模型的数据进行过滤，只显示符合条件的数据。
代理模型：QSortFilterProxyModel作为代理模型，将源模型的数据进行转换后提供给视图显示，而不需要对源模型进行任何修改或复制。
使用方法
创建源模型
首先，需要创建一个源模型，如QStandardItemModel或QSqlTableModel，并向其中添加数据。

`QStandardItemModel *sourceModel = new QStandardItemModel();` // 向sourceModel中添加数据...

创建QSortFilterProxyModel对象
然后，创建一个QSortFilterProxyModel对象，并将源模型设置为其父模型。

QSortFilterProxyModel *proxyModel = new QSortFilterProxyModel(this);  proxyModel->setSourceModel(sourceModel);

设置排序和过滤规则
根据需要，可以通过调用QSortFilterProxyModel的相应方法来设置排序和过滤规则。

设置排序规则：
使用setSortRole(int role)设置排序时使用的数据角色（默认为Qt::DisplayRole）。
使用sort(int column, Qt::SortOrder order = Qt::AscendingOrder)对指定列进行排序。
设置过滤规则：
使用setFilterRegExp(const QRegExp &regExp)或setFilterWildcard(const QString &pattern)等方法设置过滤规则。
使用setFilterKeyColumn(int column)指定过滤规则应用于哪一列（如果不指定，则默认应用于所有列）。
可以通过重写filterAcceptsRow(int source_row, const QModelIndex &source_parent) const方法来自定义过滤逻辑。
4. 将QSortFilterProxyModel设置为视图的模型
最后，将QSortFilterProxyModel设置为视图（如QTableView或QTreeView）的模型。

QTableView *view = new QTableView(); 
 view->setModel(proxyModel);

更新过滤结果
当过滤规则或排序规则发生变化时，需要调用QSortFilterProxyModel的invalidate()或invalidateFilter()方法来更新过滤结果。
注意事项
QSortFilterProxyModel不能单独使用，它需要一个源模型来提供数据。
排序和过滤操作不会影响源模型本身，只会影响通过QSortFilterProxyModel展示给视图的数据。
如果需要实现更复杂的排序或过滤逻辑，可以通过子类化QSortFilterProxyModel并重写相关方法来实现。
示例代码
以下是一个简单的示例，展示了如何使用QSortFilterProxyModel对QStandardItemModel中的数据进行排序和过滤：

#include <QApplication>  
#include <QTableView>  
#include <QStandardItemModel>  
#include <QSortFilterProxyModel>  
  
int main(int argc, char *argv[]) {  
    QApplication app(argc, argv);  
  
    QStandardItemModel *sourceModel = new QStandardItemModel();  
    // 假设这里已经向sourceModel中添加了数据  
  
    QSortFilterProxyModel *proxyModel = new QSortFilterProxyModel();  
    proxyModel->setSourceModel(sourceModel);  
  
    // 设置排序规则（例如，按第一列升序排序）  
    proxyModel->sort(0, Qt::AscendingOrder);  
  
    // 设置过滤规则（例如，过滤出包含"特定文本"的行）  
    QRegExp regExp("特定文本", Qt::CaseInsensitive, QRegExp::FixedString);  
    proxyModel->setFilterRegExp(regExp);  
  
    QTableView *view = new QTableView();  
    view->setModel(proxyModel);  
  
    view->show();  
  
    return app.exec();  
}