QSortFilterProxyModel Class

Documentation des fonctions membres

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

Construit un modèle de filtre de tri avec l'adresse parent.

[virtual noexcept] QSortFilterProxyModel::~QSortFilterProxyModel()

Détruit 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 aussi autoAcceptChildRows.

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

Prépare un changement de filtre.

Cette fonction doit être appelée si vous mettez en œuvre 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 que le filtre a été modifié, appelez endFilterChange() avec Direction::Rows pour les filtres de ligne, Direction::Columns pour les filtres de colonne, ou Direction::Columns|Direction::Rows si les lignes et les colonnes sont filtrées.

Cette fonction a été introduite dans Qt 6.9.

Voir aussi 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 également setData().

[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)

Invalide le filtrage actuel après que le paramètre de filtrage a changé.

Cette fonction doit être appelée si vous mettez en œuvre un filtrage personnalisé (par exemple filterAcceptsRow()) et que vos paramètres de filtrage ont changé. Le paramètre directions indique si le filtre personnalisé concerne les lignes, les colonnes ou les 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. Appeler directions avec la valeur Direction::Rows pour les filtres de ligne (c'est-à-dire que filterAcceptsRow() est implémenté), Direction::Columns pour les filtres de colonne (c'est-à-dire que filterAcceptsColumn() est implémenté), ou 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 source_column et source_parent doit être inclus dans le modèle ; sinon, renvoie false.

Voir aussi 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 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 détenue par l'élément concerné correspond à la chaîne de filtrage, à la chaîne de 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 devient 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 également 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()

Invalide le tri et le filtrage en cours.

Voir aussi 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é (par filterAcceptsColumn()), et que vos paramètres de filtrage ont changé. Cette fonction diffère de invalidateFilter() en ce sens qu'elle n'appelle pas filterAcceptsRow(), mais seulement filterAcceptsColumn(). Vous pouvez l'utiliser à la place de invalidateFilter() si vous souhaitez masquer ou afficher une colonne dont les lignes ne changent pas.

Avant que les paramètres de votre filtre ne changent, appelez beginFilterChange().

Cette fonction a été introduite dans Qt 6.0.

Voir aussi 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 mettez en œuvre un filtrage personnalisé (par exemple filterAcceptsRow()), et que vos paramètres de filtrage ont changé.

Avant que vos paramètres de filtrage ne changent, appelez beginFilterChange().

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

Voir aussi 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 mettez en œuvre un filtrage personnalisé (par filterAcceptsRow()), et que vos paramètres de filtrage ont changé. Cette fonction diffère de invalidateFilter() en ce sens qu'elle n'appelle pas filterAcceptsColumn(), mais seulement filterAcceptsRow(). Vous pouvez l'utiliser à la place de invalidateFilter() si vous souhaitez masquer ou afficher une ligne dont les colonnes ne changent pas.

Avant que les paramètres de votre filtre ne changent, appelez beginFilterChange().

Cette fonction a été introduite dans Qt 6.0.

Voir aussi 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 auquel se réfère l'indice donné source_left est inférieure à la valeur de l'élément auquel se réfère l'indice donné source_right, sinon renvoie false.

Cette fonction est utilisée comme l'opérateur < lors du tri et traite les types QVariant suivants :

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

Tout autre type sera converti en QString à l'aide de QVariant::toString().

La comparaison des QStringest sensible à la casse par défaut ; cela peut être modifié à l'aide de la propriété sortCaseSensitivity.

Par défaut, le Qt::DisplayRole associé au QModelIndexes est utilisé pour les comparaisons. Ceci peut être modifié en définissant la propriété sortRole.

Voir aussi 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 site QSortFilterProxyModel en fonction du site sourceIndex 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'adresse proxyIndex du modèle de filtre de tri.

Voir également 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 filtre récursif devient 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 également data().

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

Définit la chaîne fixe utilisée pour filtrer le contenu du modèle source à l'adresse pattern.

Cette méthode réinitialise les options de l'expression régulière tout en respectant la sensibilité à la casse.

Voir aussi 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 à pattern.

Cette méthode devrait être préférée pour le nouveau code car il utilisera QRegularExpression en interne.

Cette méthode réinitialise les options de l'expression régulière mais respecte la sensibilité à la casse.

// 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 aussi setFilterCaseSensitivity(), setFilterWildcard(), setFilterFixedString(), et filterRegularExpression().

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

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

Cette méthode réinitialise les options de l'expression régulière tout en respectant la sensibilité à la casse.

Voir aussi 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 également 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 par column dans order. Si l'ordre de tri column est inférieur à zéro, le modèle sera trié par la ligne du modèle source dans order.

Voir aussi sortColumn().

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

Ce signal est émis lorsque la sensibilité à la casse pour le tri passe à sortCaseSensitivity.

int QSortFilterProxyModel::sortColumn() const

Renvoie la colonne actuellement utilisée pour le tri

Cette fonction renvoie la colonne de tri la plus récemment utilisée. La valeur par défaut est -1, ce qui signifie que ce modèle proxy ne trie pas.

Voir aussi sort().

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

Ce signal est émis lorsque le paramètre de prise en compte de la locale passe à sortLocaleAware.

Qt::SortOrder QSortFilterProxyModel::sortOrder() const

Renvoie l'ordre de tri actuellement utilisé

Cette fonction renvoie l'ordre de tri le plus récemment utilisé. 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.