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

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

この関数は 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

再実装：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

再実装：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 でモデルをソートします。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

再実装：QAbstractProxyModel::supportedDropActions() const.