QSortFilterProxyModel Class

Documentation des fonctions membres

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

Crée un modèle de filtre de tri à partir de l'parent ion fournie.

[virtual noexcept] QSortFilterProxyModel::~QSortFilterProxyModel()

Supprime ce modèle de filtre de tri.

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

Ce signal est émis lorsque la valeur de la propriété « autoAcceptChildRows » est modifiée.

Cette fonction a été introduite dans Qt 6.0.

Voir également autoAcceptChildRows.

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

Prépare le remplacement du filtre.

Cette fonction doit être appelée si vous implémentez un filtrage personnalisé (par exemple, filterAcceptsRow()) et que votre paramètre de filtrage est sur le point d’être modifié.

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

Une fois le filtre modifié, appelez endFilterChange() avec Direction::Rows pour les filtres de lignes, Direction::Columns pour les filtres de colonnes, ou Direction::Columns|Direction::Rows si les lignes et les colonnes sont toutes deux filtrées.

Cette fonction a été introduite dans Qt 6.9.

Voir également endFilterChange().

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

Réimplémente : QAbstractProxyModel::buddy(const QModelIndex &index) const.

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

Réimplémente : QAbstractProxyModel::canFetchMore(const QModelIndex &parent) const.

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

Réimplémente : QAbstractItemModel::columnCount(const QModelIndex &parent) const.

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

Réimplémente : ` QAbstractProxyModel::data(const QModelIndex &proxyIndex, int role) const`.

Voir aussi setData().

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

Réimplémentez cet emplacement dans une sous-classe pour indiquer quand une modification du modèle source a une incidence sur le filtrage ou le tri. Cette fonctionnalité sert à optimiser les performances en évitant les appels inutiles à ` filterAcceptsRow()` et ` lessThan()` lorsque les modifications du modèle source n’affectent pas les résultats du tri et du filtrage. Les paramètres sourceTopLeft, sourceBottomRight et roles sont ceux émis par le signal dataChanged() du modèle source, correspondant à la modification dont la pertinence est évaluée.

Cette fonction a été introduite dans Qt 6.12.

Voir également DataChangeRelevanceFlags, filterAcceptsRow() et lessThan().

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

Réimplémente : 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)

Annule le filtrage actuel après une modification des paramètres de filtrage.

Cette fonction doit être appelée si vous implémentez un filtrage personnalisé (par exemple, filterAcceptsRow()) et que vos paramètres de filtrage ont changé. Le paramètre directions spécifie si le filtre personnalisé s'applique aux lignes, aux colonnes ou aux deux.

Appelez beginFilterChange() lorsque le paramètre de filtrage est sur le point de changer, puis appelez cette fonction une fois que les paramètres de filtrage ont été modifiés. Appelez cette fonction avec directions défini sur Direction::Rows pour les filtres de lignes (c’est-à-dire lorsque filterAcceptsRow() est implémentée), sur Direction::Columns pour les filtres de colonnes (c’est-à-dire lorsque filterAcceptsColumn() est implémentée), ou sur Direction::Both si les deux fonctions de filtrage sont implémentées.

Cette fonction a été introduite dans Qt 6.10.

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

Réimplémente : QAbstractProxyModel::fetchMore(const QModelIndex &parent).

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

Renvoie true si l'élément de la colonne indiquée par les paramètres source_column et source_parent doit être inclus dans le modèle ; sinon, renvoie false.

Voir également filterAcceptsRow(), setFilterFixedString(), setFilterRegularExpression() et setFilterWildcard().

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

Renvoie « true » si l’élément de la ligne indiquée par les paramètres « source_row » et « source_parent » doit être inclus dans le modèle ; sinon, renvoie « false ».

L’implémentation par défaut renvoie « true » si la valeur contenue par l’élément concerné correspond à la chaîne de filtrage, à la chaîne contenant des caractères génériques ou à l’expression régulière.

Voir également filterAcceptsColumn(), setFilterFixedString(), setFilterRegularExpression() et setFilterWildcard().

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

Ce signal est émis lorsque la sensibilité à la casse du filtre passe à « filterCaseSensitivity ».

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

Ce signal est émis lorsque le rôle du filtre passe à « filterRole ».

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

Réimplémente : QAbstractProxyModel::flags(const QModelIndex &index) const.

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

Réimplémente : QAbstractProxyModel::hasChildren(const QModelIndex &parent) const.

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

Réimplémente : QAbstractProxyModel::headerData(int section, Qt::Orientation orientation, int role) const.

Voir aussi setHeaderData().

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

Réimplémente : ` QAbstractItemModel::index` (int row, int column, const QModelIndex &parent) const.

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

Réimplémente : QAbstractItemModel::insertColumns(int column, int count, const QModelIndex &parent).

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

Réimplémente : QAbstractItemModel::insertRows(int row, int count, const QModelIndex &parent).

[slot] void QSortFilterProxyModel::invalidate()

Annule le tri et le filtrage actuels.

Voir également beginFilterChange() et endFilterChange().

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

Cette fonction sera obsolète à partir de la version 6.13.

Utilisez plutôt beginFilterChange() et endFilterChange(Direction::Rows).

Invalide le filtrage actuel des colonnes.

Cette fonction doit être appelée si vous implémentez un filtrage personnalisé (via filterAcceptsColumn()) et que vos paramètres de filtrage ont changé. Elle diffère de invalidateFilter() en ce qu’elle n’appelle pas filterAcceptsRow(), mais uniquement filterAcceptsColumn(). Vous pouvez l’utiliser à la place de invalidateFilter() si vous souhaitez masquer ou afficher une colonne dont les lignes ne changent pas.

Avant de modifier vos paramètres de filtrage, appelez beginFilterChange().

Cette fonction a été introduite dans Qt 6.0.

Voir également invalidate(), invalidateRowsFilter() et beginFilterChange().

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

Cette fonction sera obsolète à partir de la version 6.13.

Utilisez plutôt beginFilterChange() et endFilterChange().

Invalide le filtrage actuel.

Cette fonction doit être appelée si vous implémentez un filtrage personnalisé (par exemple, filterAcceptsRow()) et que vos paramètres de filtrage ont changé.

Avant de modifier vos paramètres de filtrage, appelez beginFilterChange().

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

Voir également invalidate(), invalidateColumnsFilter(), invalidateRowsFilter() et beginFilterChange().

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

Cette fonction sera obsolète à partir de la version 6.13.

Utilisez plutôt beginFilterChange() et endFilterChange(Direction::Columns).

Invalide le filtrage actuel des lignes.

Cette fonction doit être appelée si vous implémentez un filtrage personnalisé (via filterAcceptsRow()) et que vos paramètres de filtrage ont changé. Elle diffère de invalidateFilter() en ce qu’elle n’appelle pas filterAcceptsColumn(), mais uniquement filterAcceptsRow(). Vous pouvez l’utiliser à la place de invalidateFilter() si vous souhaitez masquer ou afficher une ligne dont les colonnes ne changent pas.

Avant de modifier vos paramètres de filtrage, appelez ` beginFilterChange()`.

Cette fonction a été introduite dans Qt 6.0.

Voir également invalidate(), invalidateFilter() et invalidateColumnsFilter().

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

Renvoie true si la valeur de l'élément référencé par l'index donné source_left est inférieure à celle de l'élément référencé par l'index donné source_right; sinon, renvoie false.

Cette fonction est utilisée comme operator< lors du tri et utilise QAbstractItemModel::compareData().

Par défaut, la comparaison des QStrings tient compte de la casse ; cela peut être modifié à l'aide de la propriété sortCaseSensitivity.

Par défaut, l’ Qt::DisplayRole associé aux QModelIndexest utilisé pour les comparaisons. Il est possible de modifier ce comportement en définissant la propriété sortRole.

Voir également sortRole, sortCaseSensitivity et dynamicSortFilter.

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

Réimplémente : ` QAbstractProxyModel::mapFromSource(const QModelIndex &sourceIndex) const`.

Renvoie l’index du modèle dans le ` QSortFilterProxyModel `, étant donné l’ sourceIndex provenant du modèle source.

Voir aussi mapToSource().

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

Réimplémente : QAbstractProxyModel::mapSelectionFromSource(const QItemSelection &sourceSelection) const.

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

Réimplémente : QAbstractProxyModel::mapSelectionToSource(const QItemSelection &proxySelection) const.

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

Réimplémente : QAbstractProxyModel::mapToSource(const QModelIndex &proxyIndex) const.

Renvoie l’index du modèle source correspondant à l’ proxyIndex donné, issu du modèle de filtre de tri.

Voir aussi 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

Réimplémente : 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

Réimplémente : QAbstractProxyModel::mimeData(const QModelIndexList &indexes) const.

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

Réimplémente : QAbstractProxyModel::mimeTypes() const.

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

Réimplémente : QAbstractItemModel::parent(const QModelIndex &index) const.

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

Ce signal est émis lorsque le paramètre du filtre récursif est défini sur « recursiveFilteringEnabled ».

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

Réimplémente : QAbstractItemModel::removeColumns(int column, int count, const QModelIndex &parent).

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

Réimplémente : QAbstractItemModel::removeRows(int row, int count, const QModelIndex &parent).

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

Réimplémente : QAbstractItemModel::rowCount(const QModelIndex &parent) const.

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

Réimplémente : QAbstractProxyModel::setData(const QModelIndex &index, const QVariant &value, int role).

Voir aussi data().

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

Définit la chaîne fixe utilisée pour filtrer le contenu du modèle source sur la valeur indiquée pattern.

Cette méthode réinitialise les options d’expression régulière tout en conservant la distinction entre majuscules et minuscules.

Voir également setFilterCaseSensitivity(), setFilterRegularExpression(), setFilterWildcard() et filterRegularExpression().

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

Définit l'expression régulière utilisée pour filtrer le contenu du modèle source sur pattern.

Cette méthode est à privilégier pour le nouveau code, car elle utilise en interne QRegularExpression.

Cette méthode réinitialise les options de l'expression régulière, mais respecte la distinction entre majuscules et minuscules.

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

Voir également setFilterCaseSensitivity(), setFilterWildcard(), setFilterFixedString() et filterRegularExpression().

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

Définit l'expression avec caractères génériques utilisée pour filtrer le contenu du modèle source selon l'pattern.

Cette méthode réinitialise les options d’expression régulière tout en conservant la distinction entre majuscules et minuscules.

Voir également setFilterCaseSensitivity(), setFilterRegularExpression(), setFilterFixedString() et filterRegularExpression().

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

Réimplémente : QAbstractProxyModel::setHeaderData(int section, Qt::Orientation orientation, const QVariant &value, int role).

Voir aussi headerData().

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

Réimplémente : QAbstractProxyModel::setSourceModel(QAbstractItemModel *sourceModel).

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

Réimplémente : QAbstractProxyModel::sibling(int row, int column, const QModelIndex &idx) const.

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

Réimplémente : QAbstractProxyModel::sort(int column, Qt::SortOrder order).

Trie le modèle selon column dans l'order donné. Si l'column de tri est inférieur à zéro, le modèle sera trié par ligne du modèle source dans l'order donné.

Voir également ` sortColumn()` ().

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

Ce signal est émis lorsque le paramètre de tri tenant compte de la casse passe à la valeur « sortCaseSensitivity ».

int QSortFilterProxyModel::sortColumn() const

Renvoie la colonne actuellement utilisée pour le tri

Cette fonction renvoie la dernière colonne de tri utilisée. La valeur par défaut est -1, ce qui signifie que ce modèle proxy n'effectue pas de tri.

Voir également sort().

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

Ce signal est émis lorsque le paramètre de prise en compte des paramètres régionaux passe à la valeur « sortLocaleAware ».

Qt::SortOrder QSortFilterProxyModel::sortOrder() const

Renvoie l'ordre de tri actuellement utilisé

Cette fonction renvoie l'ordre de tri utilisé le plus récemment. La valeur par défaut est Qt::AscendingOrder.

Voir aussi sort().

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

Ce signal est émis lorsque le rôle de tri passe à « sortRole ».

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

Réimplémente : QAbstractProxyModel::span(const QModelIndex &index) const.

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

Réimplémente : QAbstractProxyModel::supportedDropActions() const.