QSortFilterProxyModel Class

        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());
}

メンバ関数ドキュメント

[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も参照してください 。

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

再実装：QAbstractProxyModel::buddy(const QModelIndex &index) const.

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

再実装： (const QModelIndex &index) 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

再リンプルメント: (const QModelIndex &index) 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) const.

[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() の代わりにこれを使用できます。

この関数は Qt 6.0 で導入されました。

invalidate(),invalidateFilter(),invalidateRowsFilter()も参照してください 。

[protected] void QSortFilterProxyModel::invalidateFilter()

現在のフィルタリングを無効にします。

この関数は、カスタムフィルタリング（例えばfilterAcceptsRow()）を実装していて、フィルタパラメータが変更された場合に呼び出されるべきです。

invalidate()、invalidateColumnsFilter()、invalidateRowsFilter()も参照 。

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

行に対する現在のフィルタリングを無効にします。

この関数は、（filterAcceptsRow() によって）カスタム・フィルタリングを実装していて、 フィルタ・パラメータが変更された場合にコールします。この関数はinvalidateFilter() とは異なり、filterAcceptsColumn() を呼び出さず、filterAcceptsRow() だけを呼び出します。列が変化しない行を隠したり表示したりしたい場合は、invalidateFilter() の代わりにこれを使用できます。

この関数は 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 に変換される。

QStringの比較は、デフォルトでは大文字と小文字を区別します。これはsortCaseSensitivity プロパティを使用して変更できます。

デフォルトでは、QModelIndexes に関連付けられたQt::DisplayRole が比較に使用されます。これはsortRole プロパティを設定することで変更できる。

sortRole 、sortCaseSensitivity 、およびdynamicSortFilterも参照してください 。

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

再実装：QAbstractProxyModel::mapFromSource(const QModelIndex &sourceIndex) const.

ソースモデルから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

再実装： (const QItemSelection &sourceSelection) const：QAbstractProxyModel::mapSelectionToSource(const QItemSelection &proxySelection) const.

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

再実装：QAbstractProxyModel::mapToSource(const QModelIndex &proxyIndex) const.

ソートフィルタモデルから、与えられた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

再実装： (const QModelIndexList &indexes) 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

再実装：(int row, int count, const QModelIndex &parent)：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 でモデルをソートします。sortcolumn が 0 より小さい場合、モデルは与えられた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

再リンプルメント: (const QModelIndex &index) const：QAbstractProxyModel::supportedDropActions() const.