Qt学习之路(44): QSortFilterProxyModel

    本文出自 “豆子空间” 博客，原文出处http://devbean.blog.51cto.com/448512/266500

Qt为我们预定义了很多model，前面已经说过了QStringListModel、QDirModel(也算是Qt推荐使用的QFileSystemModel吧，这个在上一章最后重新加上了一段话，没有注意的朋友去看看哦)。今天我们要说的这个QSortFilterProxyModel并不能单独使用，看它的名字就会知道，它只是一个“代理”，真正的数据需要另外的一个model提供，并且它是用来排序和过滤的。所谓过滤，也就是说按照你输入的内容进行数据的筛选，很像Excel里面的过滤器。不过Qt提供的过滤功能是基于正则表达式的，因而功能强大。

 

我们从代码开始看起：

 

sortview.h

#ifndef SORTVIEW_H
#define SORTVIEW_H

#include <QtGui>

class SortView : public QWidget
{
        Q_OBJECT
public:
        SortView();

private:
        QListView *view;
        QStringListModel *model;
        QSortFilterProxyModel *modelProxy;
        QComboBox *syntaxBox;

private slots:
         void filterChanged(QString text);
};

#endif // SORTVIEW_H

 

sortview.cpp

#include "sortview.h"

SortView::SortView()
{
        model = new QStringListModel(QColor::colorNames(), this);

        modelProxy = new QSortFilterProxyModel( this);
        modelProxy->setSourceModel(model);
        modelProxy->setFilterKeyColumn(0);

        view = new QListView( this);
        view->setModel(modelProxy);

        QLineEdit *filterInput = new QLineEdit;
        QLabel *filterLabel = new QLabel(tr( "Filter"));
        QHBoxLayout *filterLayout = new QHBoxLayout;
        filterLayout->addWidget(filterLabel);
        filterLayout->addWidget(filterInput);

        syntaxBox = new QComboBox;
        syntaxBox->setSizePolicy(QSizePolicy::Expanding, QSizePolicy::Preferred);
        syntaxBox->addItem(tr( "Regular expression"), QRegExp::RegExp);
        syntaxBox->addItem(tr( "Wildcard"), QRegExp::Wildcard);
        syntaxBox->addItem(tr( "Fixed string"), QRegExp::FixedString);
        QLabel *syntaxLabel = new QLabel(tr( "Syntax"));
        QHBoxLayout *syntaxLayout = new QHBoxLayout;
        syntaxLayout->addWidget(syntaxLabel);
        syntaxLayout->addWidget(syntaxBox);

        QVBoxLayout *layout = new QVBoxLayout( this);
        layout->addWidget(view);
        layout->addLayout(filterLayout);
        layout->addLayout(syntaxLayout);

        connect(filterInput, SIGNAL(textChanged(QString)), this, SLOT(filterChanged(QString)));
}

void SortView::filterChanged(QString text)
{
        QRegExp::PatternSyntax syntax = QRegExp::PatternSyntax(
                        syntaxBox->itemData(syntaxBox->currentIndex()).toInt());
        QRegExp regExp(text, Qt::CaseInsensitive, syntax);
        modelProxy->setFilterRegExp(regExp);
}

 

至于main()函数的内容，由于和前面的代码几乎是一样的，这里就不再贴出来了。我们使用的是QColor::colorNames()函数提供的数据。这个函数返回值是一个QStringList类型的变量，可以给出预定义的颜色的名字。我们使用一个QStringListModel包装这个数据，这和前面的内容没有什么区别。然后创建一个QSortFilterProxyModel对象，使用它的setSourceModel()函数将前面定义的QStringListModel传进去，也就是我们需要对这个model进行代理。那么我们需要过滤哪一列呢？虽然QStringListModel只有一列，但是我们也需要使用setFilterKeyColumn()函数设置一下，以便让这个proxy知道要过滤的是第0列。最后重要的一点是，QListView的model必须设置为QSortFilterProxyModel，否则是看不到效果的。

 

下面的QLineEdit提供过滤数据的输入，这个没什么好说的。后面的QComboBox列出了三项：

 

syntaxBox->addItem(tr( "Regular expression"), QRegExp::RegExp);
syntaxBox->addItem(tr( "Wildcard"), QRegExp::Wildcard);
syntaxBox->addItem(tr( "Fixed string"), QRegExp::FixedString);

 

这是正则表达式的类型。正则表达式有一套通用的语法，但是对于不同的环境，正则表达式的规则可能是不一样的。第一个QregExp::RegExp提供了最一般的正则表达式语法，不过这个语法不支持贪婪限定符。这也是Qt默认的规则。如果你需要使用贪婪限定符，需要使用QRegExp::RegExp2，根据文档描述，这个将会是 Qt5 的默认规则。第二个是Unix下shell很常见的一种规则。第三个即固定表达式，也就是说基本上不使用正则表达式的。

 

我们使用connect()函数，将QLineEdit的textChanged()信号同slot连接起来。其中我们的slot函数如下所示：

 

void SortView::filterChanged(QString text)
{
        QRegExp::PatternSyntax syntax = QRegExp::PatternSyntax(
                        syntaxBox->itemData(syntaxBox->currentIndex()).toInt());
        QRegExp regExp(text, Qt::CaseInsensitive, syntax);
        modelProxy->setFilterRegExp(regExp);
}

 

第一步，使用QComboBox的选择值创建一个QRegExp::PatternSyntax对象，然后利用这个语法规则构造一个正则表达式，注意我们在QLineEdit里面输入的内容是通过参数传递进来的，然后设置proxy的过滤器的表达式。好了，就这样运行一下看看效果吧！