《使用QSortFilterProxyModel实现QTreeView行列过滤》：系列教程之十

本文属于《QTreeView使用系列教程》之一，欢迎查看其它文章。

一、QSortFilterProxyModel简介

QSortFilterProxyModel的使用比较简单，我们在上一章，使用它来实现排序时，已经大概使用过了。本章我们主要使用它实现对QTreeView中行列的筛选过滤。它是一个model代理类，需要配合原始数据model使用。

我们先来看看QSortFilterProxyModel的设置过滤器函数，如下：

void setFilterRegExp(const QRegExp &regExp);

参数QRegExp正则表达式类，其构造函数，包括pattern-匹配字符串，cs-匹配字符串是否区分大小写，syntax-使用的匹配语法(正则表达式、通配符、固定字符串等)。

enum PatternSyntax {
    RegExp,
    Wildcard,
    FixedString,
    RegExp2,
    WildcardUnix,
    W3CXmlSchema11 };
    
QRegExp(const QString &pattern, Qt::CaseSensitivity cs = Qt::CaseSensitive,
                 PatternSyntax syntax = RegExp);

故，我们只需要将QRegExp对象通过setFilterRegExp设置到代理model，就可以实现对表项的匹配过滤了。怎么样，是不是比较简单。

二、使用QSortFilterProxyModel实现基本过滤

首先，我们在界面上放置QLineEdit和QComboBox，分别输入匹配字符串和匹配语法。QComboBox添加数据，并把PatternSyntax类型的正则表达式、通配符、固定字符串枚举值，与每个item关联，如下：

    ui->comboBox->addItem(tr("正则表达式"), QRegExp::RegExp);
    ui->comboBox->addItem(tr("通配符"), QRegExp::Wildcard);
    ui->comboBox->addItem(tr("固定字符串"), QRegExp::FixedString);

界面如下：

添加QLineEdit的textChanged信号处理

void MainWindow::on_lineEdit_textChanged(const QString &text)
{
    QRegExp::PatternSyntax syntax = QRegExp::PatternSyntax(ui->comboBox->currentData().toInt());
    QRegExp regExp(text, Qt::CaseInsensitive, syntax);
    proxyModel->setFilterRegExp(regExp);
}

然后将proxyModel添加到view，就ok了。

proxyModel = new QSortFilterProxyModel(this);
proxyModel->setSourceModel(model);
proxyModel->setFilterKeyColumn(0);
ui->treeView->setModel(proxyModel);

使用正则表达式，效果：

使用通配符，效果：

使用固定字符串，效果：

小贴士：

在QTreeView下，使用QSortFilterProxyModel进行过滤，会有一个问题，就是若父节点不符合过滤条件，则父节点以及子节点都不会显示。但是我们有时候需要实现若父节点不符合过滤条件，但是其子节点中有一个符合，那么走到这个子节点的所有父节点都需要显示出来，包括子节点自身也要显示出来。在QListView、QTableView中，因为没有父子层级关系，所以不存在这个问题。接下来，下面一节我们针对这个问题对QSortFilterProxyModel进行一点改造，来解决这个问题。

本章涉及工程代码：

文末，公众号回复：34FilterExample1，即可下载。

三、派生QSortFilterProxyModel实现行列过滤

为解决上面提到的问题，我们派生QSortFilterProxyModel，重写filterAcceptsRow，如下：

bool TreeFilterProxyModel::filterAcceptsRow(int row, const QModelIndex &parent) const
{
    bool filter = QSortFilterProxyModel::filterAcceptsRow(row, parent);

    if (filter) // 若本来此节点就允许显示，则直接返回true。
    {
        return true;
    }
    else // 若此节点不允许显示，则需要判断此节点下面子节点是否有满足过滤条件的，若有，则需要显示此节点。
    {
        QModelIndex source_index = sourceModel()->index(row, 0, parent);
        for (int i = 0; i < sourceModel()->rowCount(source_index); i++)
        {
            if (filterAcceptsRow(i, source_index))
            {
                return true;
            }
        }
    }

    return false;
}

上面讲解的都是对行进行过滤，而每列都是全部显示出来的，所以在本节，我们再扩展下，实现对列的过滤。我们重写filterAcceptsColumn，实现只显示column_s至column_e之间的列，如下：

bool TreeFilterProxyModel::filterAcceptsColumn(int column, const QModelIndex &parent) const
{
    if (column_s == 0 && column_e == 0)
        return QSortFilterProxyModel::filterAcceptsColumn(column, parent);

    if (column < column_s || column > column_e)
        return false;
    return true;
}

然后将proxyModel添加到view。

proxyModel = new QSortFilterProxyModel(this);
proxyModel->setSourceModel(model);
ui->treeView->setModel(proxyModel);

然后，我们需要添加一些界面控件和处理信号槽，界面如下：

添加QLineEdit的textChanged信号处理执行过滤。

void MainWindow::on_lineEdit_textChanged(const QString &text)
{
    QRegExp::PatternSyntax syntax = QRegExp::PatternSyntax(ui->comboBox->currentData().toInt());
    QRegExp regExp(text, Qt::CaseInsensitive, syntax);
    proxyModel->setFilterRegExp(regExp);
}

添加在第几列匹配过滤器，处理函数。setFilterKeyColumn参数，index表示列号，-1表示对所有列匹配；默认值为0，只对第0列匹配。

void MainWindow::on_comboBox_2_currentIndexChanged(int index)
{
    if (index == 8)
        proxyModel->setFilterKeyColumn(-1);
    else
        proxyModel->setFilterKeyColumn(index);
}

允许显示的列功能区，添加2个QSpinBox处理函数。此处设置显示一个连续区间的列，可能不是很合理，一般第一列是肯定要显示，然后可以选择性显示其他某些列，可以不连续，此处只是简单演示一下。

void MainWindow::on_spinBox_valueChanged(int arg1)
{
    int begin = ui->spinBox->value();
    int end = ui->spinBox_2->value();
    proxyModel->setVisibleColumn(begin, end);

    on_lineEdit_textChanged(ui->lineEdit->text());
}

void MainWindow::on_spinBox_2_valueChanged(int arg1)
{
    on_spinBox_valueChanged(0);
}

实现父节点不符合过滤条件，但子节点符合，此时父节点也要显示，效果如下：

实现列过滤，效果如下：

实现在第1列匹配过滤器，效果如下：

实现在所有列匹配过滤器，效果如下：

本章涉及工程代码：

文末，公众号回复：34FilterExample2，即可下载。

---

若对你有帮助，欢迎点赞、收藏、评论，你的支持就是我的最大动力！！！

同时，阿超为大家准备了丰富的学习资料，欢迎关注公众号“超哥学编程”，即可领取。