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

Dokumentation der Mitgliedsfunktionen

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

Konstruiert ein Sortierfiltermodell mit dem angegebenen parent.

[virtual noexcept] QSortFilterProxyModel::~QSortFilterProxyModel()

Zerstört dieses Sortierfiltermodell.

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

Dieses Signal wird ausgesendet, wenn der Wert der Eigenschaft autoAcceptChildRows geändert wird.

Diese Funktion wurde in Qt 6.0 eingeführt.

Siehe auch autoAcceptChildRows.

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

Reimplements: QAbstractProxyModel::buddy(const QModelIndex &index) const.

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

Reimplements: QAbstractProxyModel::canFetchMore(const QModelIndex &parent) const.

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

Reimplements: QAbstractItemModel::columnCount(const QModelIndex &parent) const.

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

Reimplements: QAbstractProxyModel::data(const QModelIndex &proxyIndex, int role) const.

Siehe auch setData().

[override virtual] bool QSortFilterProxyModel::dropMimeData(const QMimeData *data, Qt::DropAction action, int row, int column, const QModelIndex &parent)

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

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

Reimplements: QAbstractProxyModel::fetchMore(const QModelIndex &parent).

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

Gibt true zurück, wenn das Element in der Spalte, die durch die angegebenen source_column und source_parent angegeben ist, in das Modell aufgenommen werden soll; andernfalls wird false zurückgegeben.

Siehe auch filterAcceptsRow(), setFilterFixedString(), setFilterRegularExpression(), und setFilterWildcard().

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

Gibt true zurück, wenn das Element in der durch die angegebenen source_row und source_parent angegebenen Zeile in das Modell aufgenommen werden soll; andernfalls wird false zurückgegeben.

Die Standardimplementierung gibt true zurück, wenn der Wert des betreffenden Elements mit der Filterzeichenfolge, der Platzhalterzeichenfolge oder dem regulären Ausdruck übereinstimmt.

Siehe auch filterAcceptsColumn(), setFilterFixedString(), setFilterRegularExpression(), und setFilterWildcard().

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

Dieses Signal wird ausgegeben, wenn die Groß-/Kleinschreibung des Filters auf filterCaseSensitivity wechselt.

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

Dieses Signal wird ausgegeben, wenn die Filterrolle zu filterRole wechselt.

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

Reimplements: QAbstractProxyModel::flags(const QModelIndex &index) const.

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

Reimplements: QAbstractProxyModel::hasChildren(const QModelIndex &parent) const.

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

Reimplements: QAbstractProxyModel::headerData(int section, Qt::Orientation orientation, int role) const.

Siehe auch setHeaderData().

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

Reimplements: QAbstractItemModel::index(int row, int column, const QModelIndex &parent) const.

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

Reimplements: QAbstractItemModel::insertColumns(int column, int count, const QModelIndex &parent).

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

Reimplements: QAbstractItemModel::insertRows(int row, int count, const QModelIndex &parent).

[slot] void QSortFilterProxyModel::invalidate()

Macht die aktuelle Sortierung und Filterung ungültig.

Siehe auch invalidateFilter().

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

Macht die aktuelle Filterung für die Spalten ungültig.

Diese Funktion sollte aufgerufen werden, wenn Sie eine benutzerdefinierte Filterung (durch filterAcceptsColumn()) implementieren und sich Ihre Filterparameter geändert haben. Sie unterscheidet sich von invalidateFilter() dadurch, dass sie nicht filterAcceptsRow() aufruft, sondern nur filterAcceptsColumn(). Sie können diese Funktion anstelle von invalidateFilter() verwenden, wenn Sie eine Spalte ein- oder ausblenden wollen, in der sich die Zeilen nicht ändern.

Diese Funktion wurde in Qt 6.0 eingeführt.

Siehe auch invalidate(), invalidateFilter(), und invalidateRowsFilter().

[protected] void QSortFilterProxyModel::invalidateFilter()

Macht die aktuelle Filterung ungültig.

Diese Funktion sollte aufgerufen werden, wenn Sie eine benutzerdefinierte Filterung implementieren (z. B. filterAcceptsRow()) und sich Ihre Filterparameter geändert haben.

Siehe auch invalidate(), invalidateColumnsFilter(), und invalidateRowsFilter().

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

Macht die aktuelle Filterung für die Zeilen ungültig.

Diese Funktion sollte aufgerufen werden, wenn Sie eine benutzerdefinierte Filterung (durch filterAcceptsRow()) implementieren und sich Ihre Filterparameter geändert haben. Sie unterscheidet sich von invalidateFilter() darin, dass sie nicht filterAcceptsColumn(), sondern nur filterAcceptsRow() aufruft. Sie können diese Funktion anstelle von invalidateFilter() verwenden, wenn Sie eine Zeile ein- oder ausblenden wollen, in der sich die Spalten nicht ändern.

Diese Funktion wurde in Qt 6.0 eingeführt.

Siehe auch invalidate(), invalidateFilter(), und invalidateColumnsFilter().

[virtual protected] bool QSortFilterProxyModel::lessThan(const QModelIndex &source_left, const QModelIndex &source_right) const

Gibt true zurück, wenn der Wert des Elements, auf das der angegebene Index source_left verweist, kleiner ist als der Wert des Elements, auf das der angegebene Index source_right verweist, andernfalls gibt sie false zurück.

Diese Funktion wird beim Sortieren als <-Operator verwendet und verarbeitet die folgenden QVariant Typen:

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

Jeder andere Typ wird mit QVariant::toString() in einen QString umgewandelt.

Beim Vergleich von QStringwird standardmäßig zwischen Groß- und Kleinschreibung unterschieden; dies kann mit der Eigenschaft sortCaseSensitivity geändert werden.

Standardmäßig wird der Qt::DisplayRole, der mit dem QModelIndexes verbunden ist, für Vergleiche verwendet. Dies kann durch Setzen der Eigenschaft sortRole geändert werden.

Siehe auch sortRole, sortCaseSensitivity, und dynamicSortFilter.

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

Reimplements: QAbstractProxyModel::mapFromSource(const QModelIndex &sourceIndex) const.

Liefert den Modellindex in QSortFilterProxyModel unter Angabe von sourceIndex aus dem Quellmodell.

Siehe auch mapToSource().

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

Reimplements: QAbstractProxyModel::mapSelectionFromSource(const QItemSelection &sourceSelection) const.

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

Reimplements: QAbstractProxyModel::mapSelectionToSource(const QItemSelection &proxySelection) const.

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

Reimplements: QAbstractProxyModel::mapToSource(const QModelIndex &proxyIndex) const.

Gibt den Index des Quellmodells zurück, der dem angegebenen proxyIndex des Sortierfiltermodells entspricht.

Siehe auch 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

Reimplements: 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

Reimplements: QAbstractProxyModel::mimeData(const QModelIndexList &indexes) const.

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

Reimplements: QAbstractProxyModel::mimeTypes() const.

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

Reimplements: QAbstractItemModel::parent(const QModelIndex &index) const.

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

Dieses Signal wird ausgegeben, wenn die Einstellung des rekursiven Filters auf recursiveFilteringEnabled geändert wird.

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

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

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

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

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

Reimplements: QAbstractItemModel::rowCount(const QModelIndex &parent) const.

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

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

Siehe auch data().

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

Setzt die feste Zeichenfolge, die zum Filtern des Inhalts des Quellmodells verwendet wird, auf die angegebene pattern.

Diese Methode setzt die Optionen des regulären Ausdrucks zurück, berücksichtigt aber die Groß- und Kleinschreibung.

Siehe auch setFilterCaseSensitivity(), setFilterRegularExpression(), setFilterWildcard(), und filterRegularExpression().

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

Setzt den regulären Ausdruck, der zum Filtern des Inhalts des Quellmodells verwendet wird, auf pattern.

Diese Methode sollte für neuen Code bevorzugt werden, da sie intern QRegularExpression verwendet.

Diese Methode setzt die Optionen des regulären Ausdrucks zurück, berücksichtigt aber die Groß- und Kleinschreibung.

Siehe auch setFilterCaseSensitivity(), setFilterWildcard(), setFilterFixedString(), und filterRegularExpression().

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

Setzt den Platzhalterausdruck, der zum Filtern des Inhalts des Quellmodells verwendet wird, auf den angegebenen pattern.

Diese Methode setzt die Optionen des regulären Ausdrucks zurück, wobei die Groß- und Kleinschreibung beachtet wird.

Siehe auch setFilterCaseSensitivity(), setFilterRegularExpression(), setFilterFixedString(), und filterRegularExpression().

[override virtual] bool QSortFilterProxyModel::setHeaderData(int section, Qt::Orientation orientation, const QVariant &value, int role = Qt::EditRole)

Reimplements: QAbstractProxyModel::setHeaderData(int section, Qt::Orientation orientation, const QVariant &value, int role).

Siehe auch headerData().

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

Reimplements: QAbstractProxyModel::setSourceModel(QAbstractItemModel *sourceModel).

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

Reimplements: QAbstractProxyModel::sibling(int row, int column, const QModelIndex &idx) const.

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

Reimplements: QAbstractProxyModel::sort(int column, Qt::SortOrder order).

Sortiert das Modell nach column in der angegebenen order. Wenn die Sortierreihenfolge column kleiner als Null ist, wird das Modell nach der Quellmodellzeile in der angegebenen order sortiert.

Siehe auch sortColumn().

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

Dieses Signal wird ausgegeben, wenn sich die Groß-/Kleinschreibung für die Sortierung auf sortCaseSensitivity ändert.

int QSortFilterProxyModel::sortColumn() const

Gibt die aktuell für die Sortierung verwendete Spalte zurück

Dies gibt die zuletzt verwendete Sortierspalte zurück. Der Standardwert ist -1, was bedeutet, dass dieses Proxy-Modell nicht sortiert.

Siehe auch sort().

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

Dieses Signal wird ausgegeben, wenn sich die sprachabhängige Einstellung auf sortLocaleAware ändert.

Qt::SortOrder QSortFilterProxyModel::sortOrder() const

Gibt die aktuell für die Sortierung verwendete Reihenfolge zurück

Dies gibt die zuletzt verwendete Sortierreihenfolge zurück. Der Standardwert ist Qt::AscendingOrder.

Siehe auch sort().

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

Dieses Signal wird ausgegeben, wenn die Sortierrolle zu sortRole wechselt.

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

Reimplements: QAbstractProxyModel::span(const QModelIndex &index) const.

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

Reimplements: QAbstractProxyModel::supportedDropActions() const.