QSortFilterProxyModel Class

Dokumentation zu den Mitgliedsfunktionen

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

Erstellt ein Sortierfiltermodell mit dem angegebenen „ parent “.

[virtual noexcept] QSortFilterProxyModel::~QSortFilterProxyModel()

Löscht dieses Sortierfiltermodell.

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

Dieses Signal wird ausgelöst, wenn sich der Wert der Eigenschaft „ autoAcceptChildRows “ ändert.

Diese Funktion wurde in Qt 6.0 eingeführt.

Siehe auch „ autoAcceptChildRows “.

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

Bereitet einen Filterwechsel vor.

Diese Funktion sollte aufgerufen werden, wenn Sie eine benutzerdefinierte Filterung implementieren (z. B. filterAcceptsRow()) und sich Ihr Filterparameter ändern wird.

void MySortFilterProxyModel::setFilterMaximumDate(QDate date)
{
    beginFilterChange();
    maxDate = date;
    endFilterChange(QSortFilterProxyModel::Direction::Rows);
}

Sobald der Filter geändert wurde, rufen Sie ` endFilterChange()` mit ` Direction::Rows ` für Zeilenfilter, ` Direction::Columns ` für Spaltenfilter oder ` Direction::Columns|Direction::Rows ` auf, wenn sowohl Zeilen als auch Spalten gefiltert werden.

Diese Funktion wurde in Qt 6.9 eingeführt.

Siehe auch „ endFilterChange()“.

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

Implementiert neu: ` QAbstractProxyModel::buddy(const QModelIndex &index) const`.

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

Implementiert neu: ` QAbstractProxyModel::canFetchMore(const QModelIndex &parent) const`.

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

Implementiert neu: ` QAbstractItemModel::columnCount(const QModelIndex &parent) const`.

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

Implementiert neu: ` QAbstractProxyModel::data(const QModelIndex &proxyIndex, int role) const`.

Siehe auch ` setData()`.

[protected invokable, since 6.12] QSortFilterProxyModel::DataChangeRelevanceFlags QSortFilterProxyModel::dataChangeRelevanceFlags(const QModelIndex &sourceTopLeft, const QModelIndex &sourceBottomRight, const QList<int> &roles) const

Implementieren Sie diesen Slot in einer Unterklasse neu, um anzugeben, wann eine Änderung am Quellmodell für die Filterung oder Sortierung relevant ist. Dies dient der Leistungsoptimierung, um unnötige Aufrufe von ` filterAcceptsRow()` und ` lessThan()` bei Änderungen am Quellmodell zu vermeiden, die keine Auswirkungen auf die Sortier- und Filterergebnisse haben. Die Parameter ` sourceTopLeft`, ` sourceBottomRight ` und ` roles ` sind diejenigen, die vom Signal ` dataChanged()` des Quellmodells ausgegeben werden und der Änderung entsprechen, deren Relevanz geprüft wird.

Diese Funktion wurde in Qt 6.12 eingeführt.

Siehe auch DataChangeRelevanceFlags, filterAcceptsRow() und lessThan().

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

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

[protected, since 6.10] void QSortFilterProxyModel::endFilterChange(QSortFilterProxyModel::Directions directions = Direction::Both)

Macht die aktuelle Filterung ungültig, nachdem sich der Filterparameter geändert hat.

Diese Funktion sollte aufgerufen werden, wenn Sie eine benutzerdefinierte Filterung implementieren (z. B. ` filterAcceptsRow()`) und sich Ihre Filterparameter geändert haben. Der Parameter ` directions ` gibt an, ob sich der benutzerdefinierte Filter auf Zeilen, Spalten oder beides auswirkt.

Rufen Sie ` beginFilterChange()` auf, wenn sich der Filterparameter ändern soll, und rufen Sie anschließend diese Funktion auf, sobald die Filterparameter geändert wurden. Rufen Sie die Funktion mit dem Parameter „ directions “ auf „ Direction::Rows “ gesetzt für Zeilenfilter (d. h., „ filterAcceptsRow()“ ist implementiert), auf „ Direction::Columns “ für Spaltenfilter (d. h., „ filterAcceptsColumn()“ ist implementiert) oder auf „ Direction::Both “, wenn beide Filterfunktionen implementiert sind.

Diese Funktion wurde in Qt 6.10 eingeführt.

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

Implementiert: ` 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 Parameter „ source_column “ und „ source_parent “ angegeben wird, 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 Zeile, auf die die angegebenen „ source_row “ und „ source_parent “ verweisen, 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 sich die Groß-/Kleinschreibung des Filters auf „ filterCaseSensitivity “ ändert.

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

Dieses Signal wird ausgelöst, wenn sich die Filterrolle auf „ filterRole “ ändert.

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

Implementiert neu: ` QAbstractProxyModel::flags(const QModelIndex &index) const`.

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

Implementiert neu: ` QAbstractProxyModel::hasChildren(const QModelIndex &parent) const`.

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

Implementiert neu: ` 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

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

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

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

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

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

[slot] void QSortFilterProxyModel::invalidate()

Hebt die aktuelle Sortierung und Filterung auf.

Siehe auch beginFilterChange() und endFilterChange().

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

Diese Funktion wird in Version 6.13 als veraltet markiert.

Verwenden Sie stattdessen „ beginFilterChange()“ und „ endFilterChange(Direction::Rows)“.

Hebt die aktuelle Filterung für die Spalten auf.

Diese Funktion sollte aufgerufen werden, wenn Sie eine benutzerdefinierte Filterung (mit ` filterAcceptsColumn()`) implementieren und sich Ihre Filterparameter geändert haben. Der Unterschied zu ` invalidateFilter()` besteht darin, dass hier nicht ` filterAcceptsRow()` aufgerufen wird, sondern nur ` filterAcceptsColumn()`. Sie können diese Funktion anstelle von ` invalidateFilter()` verwenden, wenn Sie eine Spalte ausblenden oder einblenden möchten, in der sich die Zeilen nicht ändern.

Rufen Sie „ beginFilterChange()“ auf, bevor sich Ihre Filterparameter ändern.

Diese Funktion wurde in Qt 6.0 eingeführt.

Siehe auch „ invalidate()“, „ invalidateRowsFilter()“ und „ beginFilterChange()“.

[protected, until 6.13] void QSortFilterProxyModel::invalidateFilter()

Diese Funktion wird in Version 6.13 als veraltet markiert.

Verwenden Sie stattdessen „ beginFilterChange()“ und „ endFilterChange()“.

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.

Rufen Sie beginFilterChange() auf, bevor sich Ihre Filterparameter ändern.

void MySortFilterProxyModel::setFilterMaximumDate(QDate date)
{
    beginFilterChange();
    maxDate = date;
    endFilterChange(QSortFilterProxyModel::Direction::Rows);
}

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

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

Diese Funktion wird in Version 6.13 als veraltet markiert.

Verwenden Sie stattdessen „ beginFilterChange()“ und „ endFilterChange “ (Direction::Columns).

Hebt die aktuelle Filterung für die Zeilen auf.

Diese Funktion sollte aufgerufen werden, wenn Sie eine benutzerdefinierte Filterung (mit ` filterAcceptsRow()`) implementieren und sich Ihre Filterparameter geändert haben. Der Unterschied zu ` invalidateFilter()` besteht darin, dass hier nicht ` filterAcceptsColumn()` aufgerufen wird, sondern nur ` filterAcceptsRow()`. Sie können diese Funktion anstelle von ` invalidateFilter()` verwenden, wenn Sie eine Zeile ausblenden oder einblenden möchten, bei der sich die Spalten nicht ändern.

Rufen Sie „ beginFilterChange()“ auf, bevor sich Ihre Filterparameter ä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 wird „ false “ zurückgegeben.

Diese Funktion wird beim Sortieren als „ operator< “ verwendet und nutzt QAbstractItemModel::compareData().

Der Vergleich von „ QStrings“ erfolgt standardmäßig unter Berücksichtigung der Groß-/Kleinschreibung; dies kann mithilfe der Eigenschaft „ sortCaseSensitivity “ geändert werden.

Standardmäßig wird der mit den „ QModelIndex“ verknüpften „ Qt::DisplayRole “ 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

Implementiert neu: ` QAbstractProxyModel::mapFromSource(const QModelIndex &sourceIndex) const`.

Gibt den Modellindex im ` QSortFilterProxyModel ` zurück, wenn der ` sourceIndex ` aus dem Quellmodell angegeben wird.

Siehe auch mapToSource().

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

Implementiert neu: ` QAbstractProxyModel::mapSelectionFromSource(const QItemSelection &sourceSelection) const`.

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

Implementiert neu: ` QAbstractProxyModel::mapSelectionToSource(const QItemSelection &proxySelection) const`.

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

Implementiert: ` QAbstractProxyModel::mapToSource(const QModelIndex &proxyIndex) const`.

Gibt den Quellmodellindex zurück, der dem angegebenen ` proxyIndex ` aus dem Sortierfiltermodell 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

Implementiert neu: ` 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

Implementiert neu: ` QAbstractProxyModel::mimeData(const QModelIndexList &indexes) const`.

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

Implementiert erneut: ` QAbstractProxyModel::mimeTypes()` const.

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

Implementiert neu: ` 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())

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

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

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

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

Implementiert: ` QAbstractItemModel::rowCount(const QModelIndex &parent) const`.

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

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

Siehe auch data().

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

Legt die feste Zeichenfolge fest, die zum Filtern des Inhalts des Quellmodells verwendet wird, und zwar auf den angegebenen Wert „ pattern “.

Diese Methode setzt die Optionen für reguläre Ausdrücke zurück, berücksichtigt jedoch die Groß-/Kleinschreibung.

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

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

Legt den regulären Ausdruck fest, der zum Filtern des Inhalts des Quellmodells verwendet wird: „ pattern “.

Diese Methode sollte bei neuem Code bevorzugt werden, da sie intern „ QRegularExpression “ verwendet.

Diese Methode setzt die Optionen für den regulären Ausdruck zurück, berücksichtigt jedoch die Groß-/Kleinschreibung.

// Connect using qOverload:
connect(sender, &SenderClass::signal,
        sortFilterProxyModel, qOverload(&QSortFilterProxyModel::setFilterRegularExpression));

// Or using a lambda as wrapper:
connect(sender, &SenderClass::signal,
        sortFilterProxyModel, [receiver = sortFilterProxyModel](const QString &pattern) { receiver->setFilterRegularExpression(pattern); });

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

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

Legt den Platzhalterausdruck fest, der zum Filtern des Inhalts des Quellmodells verwendet wird, und zwar auf den angegebenen „ pattern “.

Diese Methode setzt die Optionen für reguläre Ausdrücke zurück, berücksichtigt jedoch die Groß-/Kleinschreibung.

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

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

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

Siehe auch headerData().

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

Implementiert: ` QAbstractProxyModel::setSourceModel` (`QAbstractItemModel *sourceModel`).

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

Implementiert neu: ` QAbstractProxyModel::sibling(int row, int column, const QModelIndex &idx) const`.

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

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

Sortiert das Modell nach column in der angegebenen order. Ist der Sortier column -Wert kleiner als Null, wird das Modell nach der Quellmodellzeile in der angegebenen order sortiert.

Siehe auch ` sortColumn()` ().

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

Dieses Signal wird ausgelöst, wenn sich die Groß-/Kleinschreibung bei der Sortierung auf „ sortCaseSensitivity “ ändert.

int QSortFilterProxyModel::sortColumn() const

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

Hiermit wird die zuletzt verwendete Sortierspalte zurückgegeben. Der Standardwert ist -1, was bedeutet, dass dieses Proxy-Modell nicht sortiert.

Siehe auch ` sort()`.

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

Dieses Signal wird ausgelöst, wenn sich die Einstellung für die Lokalisierung auf „ sortLocaleAware “ ändert.

Qt::SortOrder QSortFilterProxyModel::sortOrder() const

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

Diese Funktion gibt die zuletzt verwendete Sortierreihenfolge zurück. Der Standardwert ist „ Qt::AscendingOrder “.

Siehe auch ` sort()`.

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

Dieses Signal wird ausgelöst, wenn sich die Sortierrolle auf „ sortRole “ ändert.

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

Implementiert neu: ` QAbstractProxyModel::span(const QModelIndex &index) const`.

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

Implementiert: ` QAbstractProxyModel::supportedDropActions()` const.