2024年3月13日发(作者：)

qt sortfilterproxymodel刷新机制

Qt中的SortFilterProxyModel是一个非常有用的模型，它可以对原始模型中的

数据进行排序和过滤。但是，SortFilterProxyModel的刷新机制可能会让人感

到困惑。在本文中，我们将深入探讨SortFilterProxyModel的刷新机制，以及

如何正确地使用它。

一、SortFilterProxyModel的基本使用

在使用SortFilterProxyModel之前，我们需要先了解一下它的基本使用方法。

SortFilterProxyModel是一个代理模型，它需要一个原始模型作为输入，并且

可以对原始模型中的数据进行排序和过滤。下面是一个简单的例子：

cpp

QStandardItemModel *model = new QStandardItemModel();

model->setColumnCount(2);

model->setRowCount(3);

model->setData(model->index(0, 0), "John");

model->setData(model->index(0, 1), "Doe");

model->setData(model->index(1, 0), "Jane");

model->setData(model->index(1, 1), "Doe");

model->setData(model->index(2, 0), "Bob");

model->setData(model->index(2, 1), "Smith");

QSortFilterProxyModel *proxyModel = new QSortFilterProxyModel();

proxyModel->setSourceModel(model);

proxyModel->setSortRole(Qt::DisplayRole);

proxyModel->setFilterRole(Qt::DisplayRole);

proxyModel->setFilterRegExp(QRegExp("Doe"));

QTableView *tableView = new QTableView();

tableView->setModel(proxyModel);

tableView->show();

在这个例子中，我们创建了一个QStandardItemModel，并向其中添加了一些

数据。然后，我们创建了一个QSortFilterProxyModel，并将

QStandardItemModel设置为其源模型。接着，我们设置了排序和过滤的角色

以及过滤的正则表达式。最后，我们将QSortFilterProxyModel设置为

QTableView的模型，并显示了QTableView。

二、SortFilterProxyModel的刷新机制

在上面的例子中，我们设置了过滤的正则表达式为"Doe"。这意味着只有姓氏为

"Doe"的人才会被显示出来。但是，如果我们在运行时更改了原始模型中的数据，

会发生什么呢？

cpp

model->setData(model->index(1, 1), "Smith");

我们将第二行的姓氏从"Doe"改为了"Smith"。但是，如果我们运行程序，会发

现QTableView中仍然显示的是"Doe"。这是因为SortFilterProxyModel的刷

新机制并没有及时更新视图。

SortFilterProxyModel的刷新机制是基于信号和槽的。当原始模型中的数据发

生变化时，原始模型会发出相应的信号，SortFilterProxyModel会接收到这些

信号，并根据需要更新自己的数据。然后，SortFilterProxyModel会发出自己

的信号，通知视图进行更新。

但是，SortFilterProxyModel并不会接收到所有原始模型的信号。只有一些特

定的信号会被SortFilterProxyModel接收到，例如dataChanged()、

rowsInserted()、rowsRemoved()等。如果我们更改的数据没有触发这些信号

中的任何一个，那么SortFilterProxyModel就不会更新自己的数据，也就不会

发出更新视图的信号。

在上面的例子中，我们更改了原始模型中的数据，但是并没有发出任何信号。因

此，SortFilterProxyModel并不知道原始模型中的数据已经发生了变化，也就

不会更新自己的数据，也就不会发出更新视图的信号。因此，我们需要手动调用

SortFilterProxyModel的invalidate()函数来强制刷新模型。

cpp

model->setData(model->index(1, 1), "Smith");

proxyModel->invalidate();

这样，我们就可以正确地更新视图了。

三、正确使用SortFilterProxyModel的刷新机制

在使用SortFilterProxyModel时，我们需要注意以下几点：

1. 在更改原始模型中的数据时，尽量使用setData()函数。这样可以确保发出相

应的信号，从而让SortFilterProxyModel正确地更新自己的数据。

2. 如果使用的是自定义模型，需要确保在数据发生变化时发出相应的信号。例

如，如果我们在自定义模型中添加了一个setData()函数，那么需要在该函数中

发出dataChanged()信号。

3. 如果更改的数据没有触发任何信号，需要手动调用SortFilterProxyModel

的invalidate()函数来强制刷新模型。

4. 如果需要频繁地更改原始模型中的数据，可以考虑使用

QStandardItemModel的blockSignals()函数来暂时禁用信号。这样可以避免

频繁地刷新SortFilterProxyModel，从而提高程序的性能。

总之，正确使用SortFilterProxyModel的刷新机制是非常重要的。只有正确地

更新模型，才能确保视图正确地显示数据。