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的过滤器的表达式。好了，就这样运行一下看看效果吧！