QSortFilterProxyModel Class

成员函数文档

[explicit] QSortFilterProxyModel::QSortFilterProxyModel(QObject *parent = nullptr)

用给定的parent 构建排序筛选器模型。

[virtual noexcept] QSortFilterProxyModel::~QSortFilterProxyModel()

销毁该分类筛选器模型。

[signal, since 6.0] void QSortFilterProxyModel::autoAcceptChildRowsChanged(bool autoAcceptChildRows)

autoAcceptChildRows 属性的值发生变化时会发出该信号。

此函数在 Qt 6.0 中引入。

另请参阅 autoAcceptChildRows 。

[protected, since 6.9] void QSortFilterProxyModel::beginFilterChange()

准备更改过滤器。

如果您正在执行自定义过滤（例如filterAcceptsRow() ），且过滤参数即将更改，则应调用此函数。

void MySortFilterProxyModel::setFilterMaximumDate(QDate date)
{
    beginFilterChange();
    maxDate = date;
    invalidateRowsFilter();
}

此函数在 Qt 6.9 中引入。

另请参阅 invalidateFilter()、invalidateColumnsFilter() 和invalidateRowsFilter()。

[override virtual] QModelIndex QSortFilterProxyModel::buddy(const QModelIndex &index) const

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

[override virtual] bool QSortFilterProxyModel::canFetchMore(const QModelIndex &parent) const

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

[override virtual] int QSortFilterProxyModel::columnCount(const QModelIndex &parent = QModelIndex()) const

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

[override virtual] QVariant QSortFilterProxyModel::data(const QModelIndex &index, int role = Qt::DisplayRole) const

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

另请参阅 setData().

[override virtual] 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).

[override virtual] void QSortFilterProxyModel::fetchMore(const QModelIndex &parent)

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

[virtual protected] bool QSortFilterProxyModel::filterAcceptsColumn(int source_column, const QModelIndex &source_parent) const

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

另请参阅 filterAcceptsRow()、setFilterFixedString()、setFilterRegularExpression() 和setFilterWildcard() 。

[virtual protected] bool QSortFilterProxyModel::filterAcceptsRow(int source_row, const QModelIndex &source_parent) const

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

如果相关项目持有的值与筛选字符串、通配符字符串或正则表达式相匹配，默认实现将返回true 。

另请参阅 filterAcceptsColumn()、setFilterFixedString()、setFilterRegularExpression() 和setFilterWildcard()。

[signal] void QSortFilterProxyModel::filterCaseSensitivityChanged(Qt::CaseSensitivity filterCaseSensitivity)

当过滤器的大小写敏感度更改为filterCaseSensitivity 时，将发出该信号。

[signal] void QSortFilterProxyModel::filterRoleChanged(int filterRole)

当过滤器角色更改为filterRole 时会发出该信号。

[override virtual] Qt::ItemFlags QSortFilterProxyModel::flags(const QModelIndex &index) const

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

[override virtual] bool QSortFilterProxyModel::hasChildren(const QModelIndex &parent = QModelIndex()) const

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

[override virtual] QVariant QSortFilterProxyModel::headerData(int section, Qt::Orientation orientation, int role = Qt::DisplayRole) const

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

另请参阅 setHeaderData().

[override virtual] QModelIndex QSortFilterProxyModel::index(int row, int column, const QModelIndex &parent = QModelIndex()) const

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

[override virtual] bool QSortFilterProxyModel::insertColumns(int column, int count, const QModelIndex &parent = QModelIndex())

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

[override virtual] bool QSortFilterProxyModel::insertRows(int row, int count, const QModelIndex &parent = QModelIndex())

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

[slot] void QSortFilterProxyModel::invalidate()

使当前排序和筛选无效。

另请参见 invalidateFilter()。

[protected, since 6.0] void QSortFilterProxyModel::invalidateColumnsFilter()

使列的当前过滤无效。

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

在过滤器参数发生变化之前，请调用beginFilterChange()。

此函数在 Qt 6.0 中引入。

另请参阅 invalidate()、invalidateRowsFilter() 和beginFilterChange()。

[protected] void QSortFilterProxyModel::invalidateFilter()

使当前过滤无效。

如果正在执行自定义过滤（如filterAcceptsRow()) 且过滤参数已更改，则应调用此函数。

在过滤参数发生变化之前，请调用beginFilterChange()。

void MySortFilterProxyModel::setFilterMaximumDate(QDate date)
{
    beginFilterChange();
    maxDate = date;
    invalidateRowsFilter();
}

另请参阅 invalidate()、invalidateColumnsFilter()、invalidateRowsFilter() 和beginFilterChange()。

[protected, since 6.0] void QSortFilterProxyModel::invalidateRowsFilter()

使当前的行过滤无效。

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

在过滤器参数发生变化之前，请调用beginFilterChange()。

此函数在 Qt 6.0 中引入。

另请参阅 invalidate()、invalidateFilter() 和invalidateColumnsFilter()。

[virtual protected] 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

任何其他类型都将使用QVariant::toString() 转换为QString 。

QStrings 的比较默认区分大小写；可使用sortCaseSensitivity 属性进行更改。

默认情况下，与QModelIndexes 关联的Qt::DisplayRole 用于比较。可通过设置sortRole 属性进行更改。

另请参阅 sortRole,sortCaseSensitivity, 和dynamicSortFilter 。

[override virtual] QModelIndex QSortFilterProxyModel::mapFromSource(const QModelIndex &sourceIndex) const

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

根据源模型中的sourceIndex ，返回QSortFilterProxyModel 中的模型索引。

另请参阅 mapToSource().

[override virtual] QItemSelection QSortFilterProxyModel::mapSelectionFromSource(const QItemSelection &sourceSelection) const

重实现：QAbstractProxyModel::mapSelectionFromSource(const QItemSelection &sourceSelection) const.

[override virtual] QItemSelection QSortFilterProxyModel::mapSelectionToSource(const QItemSelection &proxySelection) const

重实现：QAbstractProxyModel::mapSelectionToSource(const QItemSelection &proxySelection) const.

[override virtual] QModelIndex QSortFilterProxyModel::mapToSource(const QModelIndex &proxyIndex) const

重实现：QAbstractProxyModel::mapToSource(const QModelIndex &proxyIndex) 常量。

返回与排序筛选模型中给定的proxyIndex 相对应的源模型索引。

另请参阅 mapFromSource().

[override virtual] 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.

[override virtual] QMimeData *QSortFilterProxyModel::mimeData(const QModelIndexList &indexes) const

重实现：QAbstractProxyModel::mimeData(const QModelIndexList &indexes) const.

[override virtual] QStringList QSortFilterProxyModel::mimeTypes() const

重实现：QAbstractProxyModel::mimeTypes() const.

[override virtual] QModelIndex QSortFilterProxyModel::parent(const QModelIndex &child) const

重实现：QAbstractItemModel::parent(const QModelIndex &index) const.

[signal] void QSortFilterProxyModel::recursiveFilteringEnabledChanged(bool recursiveFilteringEnabled)

当递归过滤器设置更改为recursiveFilteringEnabled 时，将发出该信号。

[override virtual] bool QSortFilterProxyModel::removeColumns(int column, int count, const QModelIndex &parent = QModelIndex())

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

[override virtual] bool QSortFilterProxyModel::removeRows(int row, int count, const QModelIndex &parent = QModelIndex())

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

[override virtual] int QSortFilterProxyModel::rowCount(const QModelIndex &parent = QModelIndex()) const

重实现：QAbstractItemModel::rowCount(const QModelIndex &parent) const.

[override virtual] bool QSortFilterProxyModel::setData(const QModelIndex &index, const QVariant &value, int role = Qt::EditRole)

重实现：QAbstractProxyModel::setData(const QModelIndex &index, const QVariant &value, int role）。

另请参阅 data().

[slot] void QSortFilterProxyModel::setFilterFixedString(const QString &pattern)

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

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

另请参阅 setFilterCaseSensitivity()、setFilterRegularExpression()、setFilterWildcard() 和filterRegularExpression()。

[slot] void QSortFilterProxyModel::setFilterRegularExpression(const QString &pattern)

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

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

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

另请参阅 setFilterCaseSensitivity()、setFilterWildcard()、setFilterFixedString() 和filterRegularExpression()。

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

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

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

另请参阅 setFilterCaseSensitivity()、setFilterRegularExpression()、setFilterFixedString() 和filterRegularExpression()。

[override virtual] 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().

[override virtual] void QSortFilterProxyModel::setSourceModel(QAbstractItemModel *sourceModel)

重实现：QAbstractProxyModel::setSourceModel(QAbstractItemModel *sourceModel).

[override virtual] QModelIndex QSortFilterProxyModel::sibling(int row, int column, const QModelIndex &idx) const

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

[override virtual] void QSortFilterProxyModel::sort(int column, Qt::SortOrder order = Qt::AscendingOrder)

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

在给定的order 中按column 对模型排序。如果排序column 小于零，模型将按给定order 中的源模型行排序。

另请参阅 sortColumn() 。

[signal] void QSortFilterProxyModel::sortCaseSensitivityChanged(Qt::CaseSensitivity sortCaseSensitivity)

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

int QSortFilterProxyModel::sortColumn() const

返回当前用于排序的列

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

另请参阅 sort()。

[signal] void QSortFilterProxyModel::sortLocaleAwareChanged(bool sortLocaleAware)

当本地化感知设置更改为sortLocaleAware 时，将发出该信号。

Qt::SortOrder QSortFilterProxyModel::sortOrder() const

返回当前使用的排序顺序

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

另请参阅 sort() 。

[signal] void QSortFilterProxyModel::sortRoleChanged(int sortRole)

当排序角色更改为sortRole 时，将发出该信号。

[override virtual] QSize QSortFilterProxyModel::span(const QModelIndex &index) const

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

[override virtual] Qt::DropActions QSortFilterProxyModel::supportedDropActions() const

重实现：QAbstractProxyModel::supportedDropActions() const.