QtSortFilterProxyModel类

        QTreeView *treeView = new QTreeView;
        MyItemModel *model = new MyItemModel(this);

        treeView->setModel(model);

        QTreeView *treeView = new QTreeView;
        MyItemModel *sourceModel = new MyItemModel(this);
        QSortFilterProxyModel *proxyModel = new QSortFilterProxyModel(this);

        proxyModel->setSourceModel(sourceModel);
        treeView->setModel(proxyModel);

        treeView->setSortingEnabled(true);

bool MySortFilterProxyModel::lessThan(const QModelIndex &left,
                                      const QModelIndex &right) const
{
    QVariant leftData = sourceModel()->data(left);
    QVariant rightData = sourceModel()->data(right);

    if (leftData.userType() == QMetaType::QDateTime) {
        return leftData.toDateTime() < rightData.toDateTime();
    } else {
        static const QRegularExpression emailPattern("[\\w\\.]*@[\\w\\.]*");

        QString leftString = leftData.toString();
        if (left.column() == 1) {
            const QRegularExpressionMatch match = emailPattern.match(leftString);
            if (match.hasMatch())
                leftString = match.captured(0);
        }
        QString rightString = rightData.toString();
        if (right.column() == 1) {
            const QRegularExpressionMatch match = emailPattern.match(rightString);
            if (match.hasMatch())
                rightString = match.captured(0);
        }

        return QString::localeAwareCompare(leftString, rightString) < 0;
    }
}

        proxyModel->sort(2, Qt::AscendingOrder);

        proxyModel->setFilterRegularExpression(QRegularExpression("\.png", QRegularExpression::CaseInsensitiveOption));
        proxyModel->setFilterKeyColumn(1);

bool MySortFilterProxyModel::filterAcceptsRow(int sourceRow,
                                              const QModelIndex &sourceParent) const
{
    QModelIndex index0 = sourceModel()->index(sourceRow, 0, sourceParent);
    QModelIndex index1 = sourceModel()->index(sourceRow, 1, sourceParent);
    QModelIndex index2 = sourceModel()->index(sourceRow, 2, sourceParent);

    return (sourceModel()->data(index0).toString().contains(filterRegularExpression())
            || sourceModel()->data(index1).toString().contains(filterRegularExpression()))
            && dateInRange(sourceModel()->data(index2).toDate());
}

成员函数文档

[显式] QSortFilterProxyModel::QSortFilterProxyModel(QObject *parent = nullptr)

构建具有特定 parent 的排序过滤器模型。

[虚拟 noexcept] QSortFilterProxyModel::~QSortFilterProxyModel()

销毁此排序过滤器模型。

[信号，自6.0起] void QSortFilterProxyModel::autoAcceptChildRowsChanged(bool autoAcceptChildRows)

当自动接受子行属性的值发生变化时发出此信号。

此功能自 Qt 6.0 开始引入。

另请参阅 autoAcceptChildRows。

[重写虚拟] QModelIndex QSortFilterProxyModel::buddy(const QModelIndex &index) const

重新实现了：QAbstractProxyModel::buddy(const QModelIndex &index) const.

[重写虚拟] bool QSortFilterProxyModel::canFetchMore(const QModelIndex &parent) const

重新实现了：QAbstractProxyModel::canFetchMore(const QModelIndex &parent) const.

[重写虚拟] int QSortFilterProxyModel::columnCount(const QModelIndex &parent = QModelIndex()) const

重新实现了：QAbstractItemModel::columnCount(const QModelIndex &parent) const.

[重写虚拟] QVariant QSortFilterProxyModel::data(const QModelIndex &index, int role = Qt::DisplayRole) const

重新实现了：QAbstractProxyModel::data(const QModelIndex &proxyIndex, int role) const.

也请参见 setData().

[覆盖虚函数] bool QSortFilterProxyModel::dropMimeData(const QMimeData *data, Qt::DropAction action, int row, int column, const QModelIndex &parent)

重实现: QAbstractProxyModel::dropMimeData(const QMimeData *data, Qt::DropAction action, int row, int column, const QModelIndex &parent).

[覆盖虚函数] void QSortFilterProxyModel::fetchMore(const QModelIndex &parent)

重实现: QAbstractProxyModel::fetchMore(const QModelIndex &parent).

[虚拟受保护] bool QSortFilterProxyModel::filterAcceptsColumn(int source_column, const QModelIndex &source_parent) const

如果给定 source_column 和 source_parent 指示的列中的项应包含在模型中，则返回 true；否则返回 false。

也请参见 filterAcceptsRow()、setFilterFixedString()、setFilterRegularExpression() 和 setFilterWildcard().

[虚拟受保护] bool QSortFilterProxyModel::filterAcceptsRow(int source_row, const QModelIndex &source_parent) const

如果给定 source_row 和 source_parent 指示的行中的项应包含在模型中，则返回 true；否则返回 false。

默认实现如果相关项的值与过滤器字符串、通配符字符串或正则表达式匹配，则返回 true。

也请参见 filterAcceptsColumn()、setFilterFixedString()、setFilterRegularExpression() 和 setFilterWildcard().

[信号] void QSortFilterProxyModel::filterCaseSensitivityChanged(Qt::CaseSensitivity filterCaseSensitivity)

当过滤器的区分大小写更改到 filterCaseSensitivity 时，会发出此信号。

[信号] void QSortFilterProxyModel::filterRoleChanged(int filterRole)

当过滤器角色更改到 filterRole 时，会发出此信号。

[重载虚函数] Qt::ItemFlags QSortFilterProxyModel::flags(const QModelIndex &index) const

重实现了： QAbstractProxyModel::flags(const QModelIndex &index) const.

[重载虚函数] bool QSortFilterProxyModel::hasChildren(const QModelIndex &parent = QModelIndex()) const

重实现了： QAbstractProxyModel::hasChildren(const QModelIndex &parent) const.

[重载虚函数] QVariant QSortFilterProxyModel::headerData(int section, Qt::Orientation orientation, int role = Qt::DisplayRole) const

重实现了： QAbstractProxyModel::headerData(int section, Qt::Orientation orientation, int role) const.

另请参阅 setHeaderData().

[重载虚函数] QModelIndex QSortFilterProxyModel::index(int row, int column, const QModelIndex &parent = QModelIndex()) const

重实现了： QAbstractItemModel::index(int row, int column, const QModelIndex &parent) const.

[重载虚函数] bool QSortFilterProxyModel::insertColumns(int column, int count, const QModelIndex &parent = QModelIndex())

重实现了： QAbstractItemModel::insertColumns(int column, int count, const QModelIndex &parent).

[重载虚函数] bool QSortFilterProxyModel::insertRows(int row, int count, const QModelIndex &parent = QModelIndex())

重实现了： QAbstractItemModel::insertRows(int row, int count, const QModelIndex &parent).

[槽函数] void QSortFilterProxyModel::invalidate()

使当前的排序和过滤失效。

另请参阅 invalidateFilter().

[受保护，自6.0版起] void QSortFilterProxyModel::invalidateColumnsFilter()

使当前列的过滤失效。

如果您正实现自定义过滤（通过 filterAcceptsColumn()), 并且您的过滤参数已更改，则应该调用此函数。这与 invalidateFilter() 不同，因为它不会调用 filterAcceptsRow()，而只会调用 filterAcceptsColumn()。如果您想隐藏或显示行不改变的一列，可以使用此函数代替 invalidateFilter()。

此功能自 Qt 6.0 开始引入。

另请参阅 invalidate()，invalidateFilter() 和 invalidateRowsFilter。

[保护] void QSortFilterProxyModel::invalidateFilter()

使当前过滤无效。

如果你正在实现自定义过滤（例如，filterAcceptsRow()），并且你的过滤参数已更改，则应调用此函数。

另请参阅 invalidate，invalidateColumnsFilter 和 invalidateRowsFilter。

[保护，自6.0起] void QSortFilterProxyModel::invalidateRowsFilter()

使当前行过滤无效。

如果你正在实现自定义过滤（通过 filterAcceptsRow()），并且你的过滤参数已更改，则应调用此函数。这与 invalidateFilter() 的区别在于它不会调用 filterAcceptsColumn()，而只会调用 filterAcceptsRow()。如果你想根据列不变隐藏或显示行，则可以使用此方法而不是 invalidateFilter()。

此功能自 Qt 6.0 开始引入。

另请参阅 invalidate，invalidateFilter 和 invalidateColumnsFilter。

[虚拟保护] bool QSortFilterProxyModel::lessThan(const QModelIndex &source_left, const QModelIndex &source_right) const

如果给定索引 source_left 指向的项目值小于给定索引 source_right 指向的项目值，则返回 true，否则返回 false。

此函数用作排序时的 < 操作符，并处理以下 QVariant 类型

• QMetaType::Int
• QMetaType::UInt
• QMetaType::LongLong
• QMetaType::ULongLong
• QMetaType::Float
• QMetaType::Double
• QMetaType::QChar
• QMetaType::QDate
• QMetaType::QTime
• QMetaType::QDateTime
• QMetaType::QString

任何其他类型都将以 QString 的形式转换，使用 QVariant::toString。

默认情况下，QString 的比较是区分大小写的；这可以通过使用 sortCaseSensitivity 属性来更改。

默认情况下，使用与 QModelIndex 相关的 Qt::DisplayRole 进行比较。这可以通过设置 sortRole 属性来更改。

另请参阅 sortRole，sortCaseSensitivity 和 dynamicSortFilter。

[重载虚拟] QModelIndex QSortFilterProxyModel::mapFromSource(const QModelIndex &sourceIndex) const

重实： QAbstractProxyModel::mapFromSource(const QModelIndex &sourceIndex) const。

根据从源模型获取的 sourceIndex 返回 QSortFilterProxyModel 中的模型索引。

另请参阅 mapToSource()。

[重写虚函数] QItemSelection QSortFilterProxyModel::mapSelectionFromSource(const QItemSelection &sourceSelection) const

重新实现: QAbstractProxyModel::mapSelectionFromSource(const QItemSelection &sourceSelection) const。

[重写虚函数] QItemSelection QSortFilterProxyModel::mapSelectionToSource(const QItemSelection &proxySelection) const

重新实现: QAbstractProxyModel::mapSelectionToSource(const QItemSelection &proxySelection) const。

[重写虚函数] QModelIndex QSortFilterProxyModel::mapToSource(const QModelIndex &proxyIndex) const

重新实现: QAbstractProxyModel::mapToSource(const QModelIndex &proxyIndex) const。

返回对应于给定 proxyIndex 的排序过滤模型中的源模型索引。

另请参阅 mapFromSource。

[重写虚函数] QModelIndexList QSortFilterProxyModel::match(const QModelIndex &start, int role, const QVariant &value, int hits = 1, Qt::MatchFlags flags = Qt::MatchFlags(Qt::MatchStartsWith|Qt::MatchWrap)) const

重新实现: QAbstractItemModel::match(const QModelIndex &start, int role, const QVariant &value, int hits, Qt::MatchFlags flags) const。

[重写虚函数] QMimeData *QSortFilterProxyModel::mimeData(const QModelIndexList &indexes) const

重新实现: QAbstractProxyModel::mimeData(const QModelIndexList &indexes) const。

[重写虚函数] QStringList QSortFilterProxyModel::mimeTypes() const

重新实现: QAbstractProxyModel::mimeTypes() const。

[重写虚函数] QModelIndex QSortFilterProxyModel::parent(const QModelIndex &child) const

重新实现: QAbstractItemModel::parent(const QModelIndex &index) const。

[信号] void QSortFilterProxyModel::recursiveFilteringEnabledChanged(bool recursiveFilteringEnabled)

当递归过滤设置更改为 recursiveFilteringEnabled 时，会发出此信号。

[重写虚函数] bool QSortFilterProxyModel::removeColumns(int column, int count, const QModelIndex &parent = QModelIndex())

重写: QAbstractItemModel::removeColumns(int column, int count, const QModelIndex &parent).

[重写虚函数] bool QSortFilterProxyModel::removeRows(int row, int count, const QModelIndex &parent = QModelIndex())

重写: QAbstractItemModel::removeRows(int row, int count, const QModelIndex &parent).

[重写虚函数] int QSortFilterProxyModel::rowCount(const QModelIndex &parent = QModelIndex()) const

重写: QAbstractItemModel::rowCount(const QModelIndex &parent) const.

[重写虚函数] bool QSortFilterProxyModel::setData(const QModelIndex &index, const QVariant &value, int role = Qt::EditRole)

重写: QAbstractProxyModel::setData(const QModelIndex &index, const QVariant &value, int role).

另请参阅 data().

[槽函数] void QSortFilterProxyModel::setFilterFixedString(const QString &pattern)

将用于过滤源模型内容的固定字符串设置为给定的 pattern。

此方法将重置正则表达式选项，同时尊重大小写敏感性。

另请参阅 setFilterCaseSensitivity()，setFilterRegularExpression()，setFilterWildcard() 和 filterRegularExpression().

[槽函数] void QSortFilterProxyModel::setFilterRegularExpression(const QString &pattern)

将用于过滤源模型内容的正则表达式设置为 pattern。

对于新代码，应首选此方法，因为它将内部使用 QRegularExpression。

此方法将重置正则表达式选项，同时尊重大小写敏感性。

另请参阅 setFilterCaseSensitivity()，setFilterWildcard()，setFilterFixedString() 和 filterRegularExpression().

[槽] void QSortFilterProxyModel::setFilterWildcard(const QString &pattern)

设置用于过滤源模型内容的通配符表达式为给定的 pattern。

此方法将重置正则表达式选项，同时尊重大小写敏感性。

另请参阅 setFilterCaseSensitivity()，setFilterRegularExpression()，setFilterFixedString()，以及 filterRegularExpression。

[重写虚函数] bool QSortFilterProxyModel::setHeaderData(int section, Qt::Orientation orientation, const QVariant &value, int role = Qt::EditRole)

重新实现: QAbstractProxyModel::setHeaderData(int section, Qt::Orientation orientation, const QVariant &value, int role)

另请参阅 headerData。

[重写虚函数] void QSortFilterProxyModel::setSourceModel(QAbstractItemModel *sourceModel)

重新实现: QAbstractProxyModel::setSourceModel(QAbstractItemModel *sourceModel)

[重写虚函数] QModelIndex QSortFilterProxyModel::sibling(int row, int column, const QModelIndex &idx) const

重新实现: QAbstractProxyModel::sibling(int row, int column, const QModelIndex &idx) const

[重写虚函数] void QSortFilterProxyModel::sort(int column, Qt::SortOrder order = Qt::AscendingOrder)

重新实现: QAbstractProxyModel::sort(int column, Qt::SortOrder order)

[信号] void QSortFilterProxyModel::sortCaseSensitivityChanged(Qt::CaseSensitivity sortCaseSensitivity)

当排序的大小写敏感度更改为 sortCaseSensitivity 时，将发出此信号。

int QSortFilterProxyModel::sortColumn() const

返回当前用于排序的列

这将返回最近使用的排序列。默认值为 -1，表示此代理模型不排序。

另请参阅 sort。

[信号] void QSortFilterProxyModel::sortLocaleAwareChanged(bool sortLocaleAware)

当区域设置相关的设置更改为 sortLocaleAware 时，将发出此信号。

Qt::SortOrder QSortFilterProxyModel::sortOrder() const

返回当前使用的排序顺序

这将返回最近使用的排序顺序。默认值为 Qt::AscendingOrder。

另请参阅 sort。

[信号] void QSortFilterProxyModel::sortRoleChanged(int sortRole)

当排序角色变为 sortRole 时，会发出此信号。

[重载虚拟] QSize QSortFilterProxyModel::span(const QModelIndex &index) const

重写了：QAbstractProxyModel::span(const QModelIndex &index) const.

[重载虚拟] Qt::DropActions QSortFilterProxyModel::supportedDropActions() const

重写了：QAbstractProxyModel::supportedDropActions() const.