QSortFilterProxyModel实现QTreeView的过滤的缺点和改进

最新推荐文章于 2025-11-01 14:11:29 发布

原创最新推荐文章于 2025-11-01 14:11:29 发布 · 9.2k 阅读

16 ·

CC 4.0 BY-SA版权

文章标签：

#filter #qt

QT 专栏收录该内容

29 篇文章

订阅专栏

本文介绍如何使用QSortFilterProxyModel对TreeView进行关键字过滤，并针对原有方法导致符合条件的子节点被过滤的问题提出改进方案，确保正确显示所有匹配项。

一般如果需要对一个视图进行关键字过滤，我们会使用QT的类QSortFilterProxyModel，将视图（view)的模型设置为这个代理类，将代理类的源模型定义为原始模型，然后定义代理模型的filterKeyColumn, filterRole, filterFixString或filterRegExp等属性后就可以实现过滤功能。如：

MyTreeModel model;
QSortFilterProxyModel sfmodel;
MyView view;

view.setModel(&sfmodel);
sfmodel.setSourceModel(&model);
sfmodel.setFilterKeyColumn(0);	// optional
sfmodel.setFilterRole(Qt::DisplayRole); // default, optional
sfmodel.setFilterFixedString("keyword");
sfmodel.setFilterRegExp("[hH]ello");

但是对于TreeView和TreeModel，这样的做法有些缺陷，如果在子节点上的数据根据过滤规则可以显示，但它的parent节点根据过滤规则是不显示的。这样以来会因为父节点被过滤掉，而导致符合条件的子节点也一起被过滤掉了。如果需要对这个缺陷进行改进，可以这样来做：从QSortFilterProxyModel继承一个自己的代理类，重新实现它的filterAcceptsRow函数，当节点不是一个叶子节点（在末端，没有子节点）时不应用过滤规则，只对叶子节点应用过滤规则，这样就可以达到上述要求。代码如下：

// \reimp
bool MyFilterProxyModel::filterAcceptsRow ( int source_row,
                            const QModelIndex & source_parent ) const
{
    QModelIndex source_index = sourceModel()->index(source_row, 0, source_parent);
    if (sourceModel()->rowCount(source_index)>0)
        return true;
    else
        return QSortFilterProxyModel::filterAcceptsRow(source_row, source_parent);
}

上面的代码会带来一个新的缺陷，就是对于非叶子节点不应用过滤规则，对于那些没有子节点符合过滤规则，且自身节点也不符合过滤规则的节点，也会一直在视图中显示。如果需要弥补这个问题，可以继续做以下的改进：在应用过滤规则时，如果自身不符合过滤规则，再去检查所有的子节点（递归调用至所有的后代节点），若所有的子节点都不符合过滤规则，那么这个子节点就不显示，只要有一个后代节点符合规则，就需要显示这个节点。代码如下：

// \reimp
bool MyFilterProxyModel::filterAcceptsRow ( int source_row,
                            const QModelIndex & source_parent ) const
{
    bool filter = QSortFilterProxyModel::filterAcceptsRow(source_row, source_parent);

    if (filter)
    {
        return true;
    }
    else
    {
        // check all decendant's
        QModelIndex source_index = sourceModel()->index(source_row, 0, source_parent);
        for (int k=0; k<sourceModel()->rowCount(source_index); k++)
        {
            if (filterAcceptsRow(k, source_index))
            {
                return true;
            }
        }
    }

    return false;
}

按照这样的做法，就可以达到一个比较理想的过滤效果。