QSortFilterProxyModel Class
La clase QSortFilterProxyModel permite ordenar y filtrar los datos que se transmiten entre otro modelo y una vista. Más información ...
| Encabezado: | #include <QSortFilterProxyModel> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Core) target_link_libraries(mytarget PRIVATE Qt6::Core) |
| qmake: | QT += core |
| Heredan: | QAbstractProxyModel |
Tipos públicos
(since 6.12) enum class | DataChangeRelevanceFlag { NotRelevant, RelevantForFiltering, RelevantForSorting, RelevantForFilteringAndSorting } |
| flags | DataChangeRelevanceFlags |
(since 6.10) enum class | Direction { Rows, Columns, Both } |
| flags | Directions |
Propiedades
|
|
Funciones públicas
| QSortFilterProxyModel(QObject *parent = nullptr) | |
| virtual | ~QSortFilterProxyModel() |
| bool | autoAcceptChildRows() const |
| QBindable<bool> | bindableAutoAcceptChildRows() |
| QBindable<bool> | bindableDynamicSortFilter() |
| QBindable<Qt::CaseSensitivity> | bindableFilterCaseSensitivity() |
| QBindable<int> | bindableFilterKeyColumn() |
| QBindable<QRegularExpression> | bindableFilterRegularExpression() |
| QBindable<int> | bindableFilterRole() |
| QBindable<bool> | bindableIsSortLocaleAware() |
| QBindable<bool> | bindableRecursiveFilteringEnabled() |
| QBindable<Qt::CaseSensitivity> | bindableSortCaseSensitivity() |
| QBindable<int> | bindableSortRole() |
| bool | dynamicSortFilter() const |
| Qt::CaseSensitivity | filterCaseSensitivity() const |
| int | filterKeyColumn() const |
| QRegularExpression | filterRegularExpression() const |
| int | filterRole() const |
| bool | isRecursiveFilteringEnabled() const |
| bool | isSortLocaleAware() const |
| void | setAutoAcceptChildRows(bool accept) |
| void | setDynamicSortFilter(bool enable) |
| void | setFilterCaseSensitivity(Qt::CaseSensitivity cs) |
| void | setFilterKeyColumn(int column) |
| void | setFilterRole(int role) |
| void | setRecursiveFilteringEnabled(bool recursive) |
| void | setSortCaseSensitivity(Qt::CaseSensitivity cs) |
| void | setSortLocaleAware(bool on) |
| void | setSortRole(int role) |
| Qt::CaseSensitivity | sortCaseSensitivity() const |
| int | sortColumn() const |
| Qt::SortOrder | sortOrder() const |
| int | sortRole() const |
Funciones públicas reimplementadas
| virtual QModelIndex | buddy(const QModelIndex &index) const override |
| virtual bool | canFetchMore(const QModelIndex &parent) const override |
| virtual int | columnCount(const QModelIndex &parent = QModelIndex()) const override |
| virtual QVariant | data(const QModelIndex &index, int role = Qt::DisplayRole) const override |
| virtual bool | dropMimeData(const QMimeData *data, Qt::DropAction action, int row, int column, const QModelIndex &parent) override |
| virtual void | fetchMore(const QModelIndex &parent) override |
| virtual Qt::ItemFlags | flags(const QModelIndex &index) const override |
| virtual bool | hasChildren(const QModelIndex &parent = QModelIndex()) const override |
| virtual QVariant | headerData(int section, Qt::Orientation orientation, int role = Qt::DisplayRole) const override |
| virtual QModelIndex | index(int row, int column, const QModelIndex &parent = QModelIndex()) const override |
| virtual bool | insertColumns(int column, int count, const QModelIndex &parent = QModelIndex()) override |
| virtual bool | insertRows(int row, int count, const QModelIndex &parent = QModelIndex()) override |
| virtual QModelIndex | mapFromSource(const QModelIndex &sourceIndex) const override |
| virtual QItemSelection | mapSelectionFromSource(const QItemSelection &sourceSelection) const override |
| virtual QItemSelection | mapSelectionToSource(const QItemSelection &proxySelection) const override |
| virtual QModelIndex | mapToSource(const QModelIndex &proxyIndex) const override |
| virtual QModelIndexList | match(const QModelIndex &start, int role, const QVariant &value, int hits = 1, Qt::MatchFlags flags = Qt::MatchFlags(Qt::MatchStartsWith|Qt::MatchWrap)) const override |
| virtual QMimeData * | mimeData(const QModelIndexList &indexes) const override |
| virtual QStringList | mimeTypes() const override |
| virtual QModelIndex | parent(const QModelIndex &child) const override |
| virtual bool | removeColumns(int column, int count, const QModelIndex &parent = QModelIndex()) override |
| virtual bool | removeRows(int row, int count, const QModelIndex &parent = QModelIndex()) override |
| virtual int | rowCount(const QModelIndex &parent = QModelIndex()) const override |
| virtual bool | setData(const QModelIndex &index, const QVariant &value, int role = Qt::EditRole) override |
| virtual bool | setHeaderData(int section, Qt::Orientation orientation, const QVariant &value, int role = Qt::EditRole) override |
| virtual void | setSourceModel(QAbstractItemModel *sourceModel) override |
| virtual QModelIndex | sibling(int row, int column, const QModelIndex &idx) const override |
| virtual void | sort(int column, Qt::SortOrder order = Qt::AscendingOrder) override |
| virtual QSize | span(const QModelIndex &index) const override |
| virtual Qt::DropActions | supportedDropActions() const override |
Ranuras públicas
| void | invalidate() |
| void | setFilterFixedString(const QString &pattern) |
| void | setFilterRegularExpression(const QString &pattern) |
| void | setFilterRegularExpression(const QRegularExpression ®ularExpression) |
| void | setFilterWildcard(const QString &pattern) |
Señales
(since 6.0) void | autoAcceptChildRowsChanged(bool autoAcceptChildRows) |
| void | filterCaseSensitivityChanged(Qt::CaseSensitivity filterCaseSensitivity) |
| void | filterRoleChanged(int filterRole) |
| void | recursiveFilteringEnabledChanged(bool recursiveFilteringEnabled) |
| void | sortCaseSensitivityChanged(Qt::CaseSensitivity sortCaseSensitivity) |
| void | sortLocaleAwareChanged(bool sortLocaleAware) |
| void | sortRoleChanged(int sortRole) |
Funciones protegidas
(since 6.9) void | beginFilterChange() |
(since 6.12) QSortFilterProxyModel::DataChangeRelevanceFlags | dataChangeRelevanceFlags(const QModelIndex &sourceTopLeft, const QModelIndex &sourceBottomRight, const QList<int> &roles) const |
(since 6.10) void | endFilterChange(QSortFilterProxyModel::Directions directions = Direction::Both) |
| virtual bool | filterAcceptsColumn(int source_column, const QModelIndex &source_parent) const |
| virtual bool | filterAcceptsRow(int source_row, const QModelIndex &source_parent) const |
(since 6.0, until 6.13) void | invalidateColumnsFilter() |
(until 6.13) void | invalidateFilter() |
(since 6.0, until 6.13) void | invalidateRowsFilter() |
| virtual bool | lessThan(const QModelIndex &source_left, const QModelIndex &source_right) const |
Descripción detallada
QSortFilterProxyModel se puede utilizar para ordenar elementos, filtrarlos o ambas cosas. El modelo transforma la estructura de un modelo de origen asignando los índices del modelo que proporciona a nuevos índices, correspondientes a diferentes ubicaciones, para que los utilicen las vistas. Este enfoque permite reestructurar un modelo de origen determinado en lo que respecta a las vistas sin necesidad de realizar transformaciones en los datos subyacentes y sin duplicar los datos en memoria.
Supongamos que queremos ordenar y filtrar los elementos proporcionados por un modelo personalizado. El código para configurar el modelo y la vista, sin ordenación ni filtrado, tendría este aspecto:
QTreeView *treeView = new QTreeView;
MyItemModel *model = new MyItemModel(this);
treeView->setModel(model);Para añadir soporte de ordenación y filtrado a MyItemModel, debemos crear un QSortFilterProxyModel, llamar a setSourceModel() con MyItemModel como argumento e instalar el QSortFilterProxyModel en la vista:
QTreeView *treeView = new QTreeView;
MyItemModel *sourceModel = new MyItemModel(this);
QSortFilterProxyModel *proxyModel = new QSortFilterProxyModel(this);
proxyModel->setSourceModel(sourceModel);
treeView->setModel(proxyModel);En este momento, no está habilitada ni la ordenación ni el filtrado; los datos originales se muestran en la vista. Cualquier cambio realizado a través del QSortFilterProxyModel se aplica al modelo original.
El QSortFilterProxyModel actúa como un envoltorio del modelo original. Si necesitas convertir los QModelIndexes de origen en índices del modelo ordenados o filtrados, o viceversa, utiliza mapToSource(), mapFromSource(), mapSelectionToSource() y mapSelectionFromSource().
Nota: De forma predeterminada, el modelo vuelve a ordenar y filtrar dinámicamente los datos cada vez que cambia el modelo original. Este comportamiento se puede modificar configurando la propiedad « dynamicSortFilter ».
Los ejemplos «Modelo básico de ordenación y filtrado» y «Modelo personalizado de ordenación y filtrado» ilustran cómo utilizar QSortFilterProxyModel para realizar operaciones básicas de ordenación y filtrado, y cómo crear una subclase del mismo para implementar un comportamiento personalizado.
Ordenación
QTableView y « QTreeView » disponen de una propiedad « sortingEnabled » que controla si el usuario puede ordenar la vista haciendo clic en el encabezado horizontal de la misma. Por ejemplo:
treeView->setSortingEnabled(true);Cuando esta función está activada (por defecto está desactivada), al hacer clic en una sección del encabezado se ordenan los elementos según esa columna. Al hacer clic repetidamente, el usuario puede alternar entre el orden ascendente y descendente.

En segundo plano, la vista llama a la función virtual ` sort()` del modelo para reordenar los datos del mismo. Para que tus datos sean ordenables, puedes implementar ` sort()` en tu modelo o utilizar un `QSortFilterProxyModel` para envolver tu modelo; `QSortFilterProxyModel` proporciona una reimplementación genérica de ` sort()` que opera sobre el ` sortRole()` (por defecto, `Qt::DisplayRole `) de los elementos y que admite varios tipos de datos, incluidos ` int`, ` QString`, y QDateTime. En el caso de los modelos jerárquicos, la ordenación se aplica de forma recursiva a todos los elementos hijos. Las comparaciones de cadenas distinguen entre mayúsculas y minúsculas de forma predeterminada; esto se puede modificar configurando la propiedad sortCaseSensitivity.
Se puede personalizar el comportamiento de ordenación creando una subclase de `QSortFilterProxyModel` y reimplementando el método ` lessThan()`, que se utiliza para comparar elementos. Por ejemplo:
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();
static const QRegularExpression emailPattern(u"[\\w\\.]*@[\\w\\.]*"_s);
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;
}(Este fragmento de código procede del ejemplo «Modelo de ordenación y filtrado personalizados» ).
Una forma alternativa de ordenar es desactivar la ordenación en la vista e imponer un orden determinado al usuario. Esto se consigue llamando explícitamente a ` sort()` con la columna y el orden deseados como argumentos en el `QSortFilterProxyModel` (o en el modelo original si este implementa ` sort()`). Por ejemplo:
proxyModel->sort(2, Qt::AscendingOrder);El `QSortFilterProxyModel` se puede ordenar por la columna -1; en ese caso, vuelve al orden de clasificación del modelo de origen subyacente.
Nota: sortColumn() devuelve la columna de ordenación utilizada más recientemente. El valor por defecto es -1, lo que significa que este modelo proxy no ordena. Además, ten en cuenta que sort() establece sortColumn() en la columna de ordenación utilizada más recientemente.
Filtrado
Además de ordenar, QSortFilterProxyModel se puede utilizar para ocultar elementos que no cumplan con un filtro determinado. El filtro se especifica mediante un objeto QRegularExpression y se aplica a la filterRole() (Qt::DisplayRole por defecto) de cada elemento, para una columna determinada. El objeto ` QRegularExpression ` se puede utilizar para buscar coincidencias con una expresión regular, un patrón con comodines o una cadena fija. Por ejemplo:
proxyModel->setFilterRegularExpression(QRegularExpression("\\.png", QRegularExpression::CaseInsensitiveOption));
proxyModel->setFilterKeyColumn(1);En los modelos jerárquicos, el filtro se aplica de forma recursiva a todos los elementos hijos. Si un elemento padre no cumple con el filtro, no se mostrará ninguno de sus elementos hijos.
Un caso de uso habitual es permitir que el usuario especifique la expresión regular, el patrón con comodines o la cadena fija del filtro en un « QLineEdit ». Para ello, conecta la señal « QLineEdit::textChanged()» o « textEdited()» a « setFilterRegularExpression()», « setFilterWildcard()» o « setFilterFixedString()».
Se puede personalizar el comportamiento del filtrado reimplementando las funciones « filterAcceptsRow()» y « filterAcceptsColumn()». Por ejemplo (tomado del ejemplo «Modelo de ordenación/filtrado personalizado» ), la siguiente implementación ignora la propiedad « filterKeyColumn » y aplica el filtrado a las columnas 0, 1 y 2:
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());
}(Este fragmento de código procede del ejemplo «Modelo personalizado de ordenación y filtrado »).
Si estás trabajando con grandes cantidades de filtrado y tienes que invocar beginFilterChange() / endFilterChange() repetidamente, el uso de beginResetModel() / endResetModel() puede resultar más eficiente, dependiendo de la implementación de tu modelo. Sin embargo, beginResetModel() / endResetModel() devuelve el modelo proxy a su estado original, perdiendo la información de selección, y provocará que el modelo proxy se vuelva a rellenar.
Subclasificación
Dado que ` QAbstractProxyModel ` y sus subclases derivan de ` QAbstractItemModel`, gran parte de los consejos sobre la subclasificación de modelos normales también se aplican a los modelos proxy. Además, cabe señalar que muchas de las implementaciones predeterminadas de las funciones de esta clase están escritas de tal forma que llaman a las funciones equivalentes del modelo fuente correspondiente. Es posible que sea necesario anular este sencillo mecanismo de proxy en el caso de modelos de origen con un comportamiento más complejo; por ejemplo, si el modelo de origen proporciona una implementación personalizada de hasChildren(), también deberías proporcionar una en el modelo proxy.
Nota: En la Referencia sobre subclasificación de modelos se ofrecenalgunas directrices generales para la subclasificación de modelos.
Véase también « QAbstractProxyModel» , « QAbstractItemModel », «Model/View Programming», «Basic Sort/Filter Model Example», «Custom Sort/Filter Model Example» y « QIdentityProxyModel ».
Documentación sobre los tipos de miembros
[since 6.12] enum class QSortFilterProxyModel::DataChangeRelevanceFlag
flags QSortFilterProxyModel::DataChangeRelevanceFlags
Esta enumeración se utiliza para especificar la operación a la que se refiere un cambio en el código fuente.
| Constante | Valor | Descripción |
|---|---|---|
QSortFilterProxyModel::DataChangeRelevanceFlag::NotRelevant | 0x00 | El cambio no es relevante ni para el filtrado ni para la ordenación |
QSortFilterProxyModel::DataChangeRelevanceFlag::RelevantForFiltering | 0x01 | El cambio es relevante para el filtrado |
QSortFilterProxyModel::DataChangeRelevanceFlag::RelevantForSorting | 0x02 | El cambio es relevante para la ordenación |
QSortFilterProxyModel::DataChangeRelevanceFlag::RelevantForFilteringAndSorting | RelevantForFiltering | RelevantForSorting | El cambio es relevante tanto para el filtrado como para la clasificación |
Esta enumeración se introdujo en Qt 6.12.
El tipo `DataChangeRelevanceFlags` es una definición de tipo (`typedef`) para ` QFlags<DataChangeRelevanceFlag>`. Almacena una combinación OR de valores de `DataChangeRelevanceFlag`.
Véase también dataChangeRelevanceFlags().
[since 6.10] enum class QSortFilterProxyModel::Direction
flags QSortFilterProxyModel::Directions
Esta enumeración se utiliza para especificar la dirección en la que se aplica un filtro personalizado cuando se modifican los parámetros del filtro.
| Constante | Valor | Descripción |
|---|---|---|
QSortFilterProxyModel::Direction::Rows | 0x01 | El filtro se aplica a rows |
QSortFilterProxyModel::Direction::Columns | 0x02 | El filtro se aplica a columns |
QSortFilterProxyModel::Direction::Both | Rows | Columns | El filtro se aplica tanto a las filas como a las columnas |
Esta enumeración se introdujo en Qt 6.10.
El tipo «Directions» es una definición de tipo (typedef) para QFlags<Direction>. Almacena una combinación OR de valores de «Direction».
Véase también beginFilterChange() y endFilterChange().
Documentación de la propiedad
[bindable, since 6.0] autoAcceptChildRows : bool
Nota: Esta propiedad admite enlaces de tipo « QProperty ».
Si el valor es «true», el modelo proxy no filtrará los elementos secundarios de las filas aceptadas, aunque estos serían filtrados en otras circunstancias.
El valor por defecto es «false».
Esta enumeración se introdujo en Qt 6.0.
Funciones de acceso:
| bool | autoAcceptChildRows() const |
| void | setAutoAcceptChildRows(bool accept) |
Señal de notificador:
| void | autoAcceptChildRowsChanged(bool autoAcceptChildRows) |
Véase también recursiveFilteringEnabled y filterAcceptsRow().
[bindable] dynamicSortFilter : bool
Nota: Esta propiedad admite enlaces de tipo « QProperty ».
Esta propiedad indica si el modelo proxy se ordena y filtra dinámicamente cada vez que cambia el contenido del modelo de origen
Ten en cuenta que no debes actualizar el modelo de origen a través del modelo proxy cuando dynamicSortFilter sea true. Por ejemplo, si se establece el modelo proxy en un ` QComboBox`, el uso de funciones que actualizan el modelo, como ` addItem()`, no funcionará como se espera. Una alternativa es establecer `dynamicSortFilter` en `false` y llamar a ` sort()` después de añadir elementos al ` QComboBox`.
El valor por defecto es true.
Funciones de acceso:
| bool | dynamicSortFilter() const |
| void | setDynamicSortFilter(bool enable) |
Véase también sortColumn().
[bindable] filterCaseSensitivity : Qt::CaseSensitivity
Nota: Esta propiedad admite enlaces de tipo « QProperty ».
Esta propiedad determina si se distingue entre mayúsculas y minúsculas en el patrón « QRegularExpression » utilizado para filtrar el contenido del modelo de origen.
De forma predeterminada, el filtro distingue entre mayúsculas y minúsculas.
Nota: Al configurar esta propiedad, se propaga la nueva distinción entre mayúsculas y minúsculas a la propiedad « filterRegularExpression », lo que rompe su enlace. Del mismo modo, al establecer explícitamente « filterRegularExpression » se cambia la distinción entre mayúsculas y minúsculas actual, rompiendo así su enlace.
Funciones de acceso:
| Qt::CaseSensitivity | filterCaseSensitivity() const |
| void | setFilterCaseSensitivity(Qt::CaseSensitivity cs) |
Señal de notificación:
| void | filterCaseSensitivityChanged(Qt::CaseSensitivity filterCaseSensitivity) |
Véase también « filterRegularExpression » y « sortCaseSensitivity ».
[bindable] filterKeyColumn : int
Nota: Esta propiedad admite enlaces de tipo « QProperty ».
Esta propiedad indica la columna de la que se lee la clave utilizada para filtrar el contenido del modelo de origen.
El valor por defecto es 0. Si el valor es -1, las claves se leerán de todas las columnas.
Funciones de acceso:
| int | filterKeyColumn() const |
| void | setFilterKeyColumn(int column) |
[bindable] filterRegularExpression : QRegularExpression
Nota: Esta propiedad admite enlaces de tipo « QProperty ».
Esta propiedad contiene el QRegularExpression utilizado para filtrar el contenido del modelo de origen
Al configurar esta propiedad mediante la sobrecarga de ` QRegularExpression `, se sobrescribe el valor actual de ` filterCaseSensitivity`. Por defecto, ` QRegularExpression ` es una cadena vacía que coincide con todo el contenido.
Si no se establece ningún « QRegularExpression » o se establece una cadena vacía, se aceptará todo el contenido del modelo de origen.
La expresión regular se compara con cada fila del modelo de origen, por lo que un patrón complejo o mal formado puede ralentizar o bloquear toda la aplicación, especialmente cuando se utiliza con modelos de gran tamaño. Se recomienda a los desarrolladores de aplicaciones que evalúen el rendimiento y la escalabilidad de la expresión regular antes de utilizarla. Si la expresión regular procede de una entrada potencialmente no fiable, considere la posibilidad de depurarla antes de pasarla a este método o de utilizar ` setFilterFixedString()` en su lugar.
Nota: Al establecer esta propiedad, se propaga la distinción entre mayúsculas y minúsculas de la nueva expresión regular a la propiedad ` filterCaseSensitivity `, lo que rompe su enlace. Del mismo modo, al establecer explícitamente ` filterCaseSensitivity ` se cambia la distinción entre mayúsculas y minúsculas de la expresión regular actual, rompiendo así su enlace.
Funciones de acceso:
| QRegularExpression | filterRegularExpression() const |
| void | setFilterRegularExpression(const QString &pattern) |
| void | setFilterRegularExpression(const QRegularExpression ®ularExpression) |
Véase también filterCaseSensitivity, setFilterWildcard() y setFilterFixedString().
[bindable] filterRole : int
Nota: Esta propiedad admite enlaces de tipo « QProperty ».
Esta propiedad contiene el rol de elemento que se utiliza para consultar los datos del modelo de origen al filtrar elementos.
El valor por defecto es Qt::DisplayRole.
Funciones de acceso:
| int | filterRole() const |
| void | setFilterRole(int role) |
Señal de notificador:
| void | filterRoleChanged(int filterRole) |
Véase también filterAcceptsRow().
[bindable] isSortLocaleAware : bool
Nota: Esta propiedad admite enlaces de tipo « QProperty ».
Esta propiedad contiene la configuración de «local awareness» utilizada para comparar cadenas al ordenar
De forma predeterminada, la ordenación no tiene en cuenta el contexto local.
Funciones de acceso:
| bool | isSortLocaleAware() const |
| void | setSortLocaleAware(bool on) |
Señal de notificación:
| void | sortLocaleAwareChanged(bool sortLocaleAware) |
Véase también sortCaseSensitivity y lessThan().
[bindable] recursiveFilteringEnabled : bool
Nota: Esta propiedad admite enlaces de tipo « QProperty ».
Esta propiedad indica si el filtro se aplicará de forma recursiva a los elementos secundarios y, para cualquier elemento secundario que coincida, sus elementos principales también serán visibles.
El valor por defecto es «false».
Funciones de acceso:
| bool | isRecursiveFilteringEnabled() const |
| void | setRecursiveFilteringEnabled(bool recursive) |
Señal de notificador:
| void | recursiveFilteringEnabledChanged(bool recursiveFilteringEnabled) |
Véase también autoAcceptChildRows y filterAcceptsRow().
[bindable] sortCaseSensitivity : Qt::CaseSensitivity
Nota: Esta propiedad admite enlaces de tipo « QProperty ».
Esta propiedad contiene la configuración de distinción entre mayúsculas y minúsculas que se utiliza para comparar cadenas al ordenarlas
De forma predeterminada, la ordenación distingue entre mayúsculas y minúsculas.
Funciones de acceso:
| Qt::CaseSensitivity | sortCaseSensitivity() const |
| void | setSortCaseSensitivity(Qt::CaseSensitivity cs) |
Señal de notificación:
| void | sortCaseSensitivityChanged(Qt::CaseSensitivity sortCaseSensitivity) |
Véase también filterCaseSensitivity y lessThan().
[bindable] sortRole : int
Nota: Esta propiedad admite enlaces de tipo « QProperty ».
Esta propiedad contiene la función del elemento que se utiliza para consultar los datos del modelo de origen al ordenar los elementos.
El valor por defecto es Qt::DisplayRole.
Funciones de acceso:
| int | sortRole() const |
| void | setSortRole(int role) |
Señal de notificador:
| void | sortRoleChanged(int sortRole) |
Véase también lessThan().
Documentación de funciones de miembro
[explicit] QSortFilterProxyModel::QSortFilterProxyModel(QObject *parent = nullptr)
Crea un modelo de filtro de ordenación con el parent proporcionado.
[virtual noexcept] QSortFilterProxyModel::~QSortFilterProxyModel()
Elimina este modelo de filtro de ordenación.
[signal, since 6.0] void QSortFilterProxyModel::autoAcceptChildRowsChanged(bool autoAcceptChildRows)
Esta señal se emite cuando cambia el valor de la propiedad « autoAcceptChildRows ».
Nota: Señalde notificación para la propiedad ` autoAcceptChildRows`.
Esta función se introdujo en Qt 6.0.
Véase también ` autoAcceptChildRows`.
[protected, since 6.9] void QSortFilterProxyModel::beginFilterChange()
Prepara un cambio del filtro.
Esta función debe llamarse si se está implementando un filtrado personalizado (por ejemplo, filterAcceptsRow())) y el parámetro del filtro está a punto de cambiar.
void MySortFilterProxyModel::setFilterMaximumDate(QDate date)
{
beginFilterChange();
maxDate = date;
endFilterChange(QSortFilterProxyModel::Direction::Rows);
}Una vez cambiado el filtro, llama a endFilterChange() con Direction::Rows para los filtros de filas, Direction::Columns para los filtros de columnas, o Direction::Columns|Direction::Rows si se filtran tanto filas como columnas.
Esta función se introdujo en Qt 6.9.
Véase también endFilterChange().
[override virtual] QModelIndex QSortFilterProxyModel::buddy(const QModelIndex &index) const
Reimplementa: ` QAbstractProxyModel::buddy(const QModelIndex &index) const`.
[override virtual] bool QSortFilterProxyModel::canFetchMore(const QModelIndex &parent) const
Reimplementa: QAbstractProxyModel::canFetchMore(const QModelIndex &parent) const.
[override virtual] int QSortFilterProxyModel::columnCount(const QModelIndex &parent = QModelIndex()) const
Reimplementa: QAbstractItemModel::columnCount(const QModelIndex &parent) const.
[override virtual] QVariant QSortFilterProxyModel::data(const QModelIndex &index, int role = Qt::DisplayRole) const
Reimplementa: ` QAbstractProxyModel::data(const QModelIndex &proxyIndex, int role) const`.
Véase también setData().
[protected invokable, since 6.12] QSortFilterProxyModel::DataChangeRelevanceFlags QSortFilterProxyModel::dataChangeRelevanceFlags(const QModelIndex &sourceTopLeft, const QModelIndex &sourceBottomRight, const QList<int> &roles) const
Reimplementa esta ranura en una subclase para indicar cuándo un cambio en el modelo de origen es relevante para el filtrado o la ordenación. Se utiliza como optimización del rendimiento para evitar llamadas innecesarias a filterAcceptsRow() y lessThan() ante cambios en el modelo de origen que no afectan a los resultados de la ordenación y el filtrado. Los parámetros sourceTopLeft, sourceBottomRight y roles son los emitidos por la señal dataChanged() del modelo fuente correspondiente al cambio cuya relevancia se está evaluando.
Nota: Debido a restricciones de compatibilidad binaria, este método no puede ser virtual hasta Qt 7. Mientras tanto, redéclaralo en una subclase como un slot o un método Q_INVOKABLE y QSortFilterProxyModel lo detectará e invocará dinámicamente.
Nota: La implementación por defecto asume que cualquier cambio es relevante para el filtrado, y que solo los cambios en la columna de ordenación de origen son relevantes para la ordenación.
Nota: Esta función se puede invocar a través del sistema de metaobjetos y desde QML. Véase Q_INVOKABLE.
Esta función se introdujo en Qt 6.12.
Véase también DataChangeRelevanceFlags, filterAcceptsRow() y lessThan().
[override virtual] bool QSortFilterProxyModel::dropMimeData(const QMimeData *data, Qt::DropAction action, int row, int column, const QModelIndex &parent)
Reimplementa: 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)
Anula el filtrado actual tras un cambio en los parámetros del filtro.
Esta función debe llamarse si se implementa un filtrado personalizado (por ejemplo, ` filterAcceptsRow()`) y los parámetros del filtro han cambiado. El parámetro ` directions ` especifica si el filtro personalizado afecta a las filas, a las columnas o a ambas.
Llama a beginFilterChange() cuando el parámetro de filtro esté a punto de cambiar y, a continuación, llama a esta función una vez que se hayan modificado los parámetros de filtro. Llámala con directions establecido en Direction::Rows para filtros de filas (es decir, cuando se haya implementado filterAcceptsRow()), en Direction::Columns para filtros de columnas (es decir, cuando se haya implementado filterAcceptsColumn()) o en Direction::Both si se han implementado ambas funciones de filtro.
Esta función se introdujo en Qt 6.10.
[override virtual] void QSortFilterProxyModel::fetchMore(const QModelIndex &parent)
Reimplementa: ` QAbstractProxyModel::fetchMore(const QModelIndex &parent)`.
[virtual protected] bool QSortFilterProxyModel::filterAcceptsColumn(int source_column, const QModelIndex &source_parent) const
Devuelve ` true ` si el elemento de la columna indicada por los parámetros ` source_column ` y ` source_parent ` debe incluirse en el modelo; en caso contrario, devuelve ` false`.
Nota: La implementación por defecto siempre devuelve true. Debes reimplementar este método para obtener el comportamiento descrito.
Véase también filterAcceptsRow(), setFilterFixedString(), setFilterRegularExpression() y setFilterWildcard().
[virtual protected] bool QSortFilterProxyModel::filterAcceptsRow(int source_row, const QModelIndex &source_parent) const
Devuelve « true » si el elemento de la fila indicada por los parámetros « source_row » y « source_parent » debe incluirse en el modelo; en caso contrario, devuelve «false».
La implementación por defecto devuelve « true » si el valor que contiene el elemento en cuestión coincide con la cadena de filtro, la cadena con comodines o la expresión regular.
Nota: Por defecto, se utiliza el valor « Qt::DisplayRole » para determinar si la fila debe aceptarse o no. Esto puede modificarse configurando la propiedad « filterRole ».
Véase también filterAcceptsColumn(), setFilterFixedString(), setFilterRegularExpression() y setFilterWildcard().
[signal] void QSortFilterProxyModel::filterCaseSensitivityChanged(Qt::CaseSensitivity filterCaseSensitivity)
Esta señal se emite cuando la distinción entre mayúsculas y minúsculas del filtro cambia a « filterCaseSensitivity ».
Nota: Señalde notificación para la propiedad « filterCaseSensitivity ».
[signal] void QSortFilterProxyModel::filterRoleChanged(int filterRole)
Esta señal se emite cuando la función del filtro cambia a « filterRole ».
Nota: Señalde notificación para la propiedad filterRole.
[override virtual] Qt::ItemFlags QSortFilterProxyModel::flags(const QModelIndex &index) const
Reimplementa: ` QAbstractProxyModel::flags(const QModelIndex &index) const`.
[override virtual] bool QSortFilterProxyModel::hasChildren(const QModelIndex &parent = QModelIndex()) const
Reimplementa: ` QAbstractProxyModel::hasChildren(const QModelIndex &parent) const`.
[override virtual] QVariant QSortFilterProxyModel::headerData(int section, Qt::Orientation orientation, int role = Qt::DisplayRole) const
Reimplementa: ` QAbstractProxyModel::headerData(int section, Qt::Orientation orientation, int role) const`.
Véase también setHeaderData().
[override virtual] QModelIndex QSortFilterProxyModel::index(int row, int column, const QModelIndex &parent = QModelIndex()) const
Reimplementa: ` QAbstractItemModel::index` (int row, int column, const QModelIndex &parent) const.
[override virtual] bool QSortFilterProxyModel::insertColumns(int column, int count, const QModelIndex &parent = QModelIndex())
Reimplementa: ` QAbstractItemModel::insertColumns` (int column, int count, const QModelIndex &parent).
[override virtual] bool QSortFilterProxyModel::insertRows(int row, int count, const QModelIndex &parent = QModelIndex())
Reimplementa: QAbstractItemModel::insertRows(int row, int count, const QModelIndex &parent).
[slot] void QSortFilterProxyModel::invalidate()
Anula la ordenación y el filtrado actuales.
Véase también beginFilterChange() y endFilterChange().
[protected, since 6.0, until 6.13] void QSortFilterProxyModel::invalidateColumnsFilter()
Está previsto que esta función quede obsoleta en la versión 6.13.
Utiliza en su lugar beginFilterChange() y endFilterChange(Direction::Rows).
Invalida el filtrado actual de las columnas.
Esta función debe llamarse si estás implementando un filtrado personalizado (mediante filterAcceptsColumn()) y tus parámetros de filtrado han cambiado. Se diferencia de invalidateFilter() en que no invocará a filterAcceptsRow(), sino solo a filterAcceptsColumn(). Puedes utilizarla en lugar de invalidateFilter() si deseas ocultar o mostrar una columna en la que las filas no cambian.
Antes de que cambien los parámetros del filtro, llama a beginFilterChange().
Esta función se introdujo en Qt 6.0.
Véase también invalidate(), invalidateRowsFilter() y beginFilterChange().
[protected, until 6.13] void QSortFilterProxyModel::invalidateFilter()
Está previsto que esta función quede obsoleta en la versión 6.13.
Utiliza en su lugar beginFilterChange() y endFilterChange().
Invalida el filtrado actual.
Esta función debe llamarse si está implementando un filtrado personalizado (por ejemplo, ` filterAcceptsRow()`) y los parámetros de su filtro han cambiado.
Antes de que cambien los parámetros del filtro, llame a ` beginFilterChange()`.
void MySortFilterProxyModel::setFilterMaximumDate(QDate date)
{
beginFilterChange();
maxDate = date;
endFilterChange(QSortFilterProxyModel::Direction::Rows);
}Véase también invalidate(), invalidateColumnsFilter(), invalidateRowsFilter() y beginFilterChange().
[protected, since 6.0, until 6.13] void QSortFilterProxyModel::invalidateRowsFilter()
Está previsto que esta función quede obsoleta en la versión 6.13.
Utiliza en su lugar beginFilterChange() y endFilterChange(Direction::Columns).
Invalida el filtrado actual de las filas.
Esta función debe llamarse si se está implementando un filtrado personalizado (mediante filterAcceptsRow()) y los parámetros del filtro han cambiado. Se diferencia de invalidateFilter() en que no invoca a filterAcceptsColumn(), sino solo a filterAcceptsRow(). Puedes utilizarla en lugar de invalidateFilter() si deseas ocultar o mostrar una fila en la que las columnas no cambian.
Antes de que cambien los parámetros de tu filtro, llama a beginFilterChange().
Esta función se introdujo en Qt 6.0.
Véanse también invalidate(), invalidateFilter() y invalidateColumnsFilter().
[virtual protected] bool QSortFilterProxyModel::lessThan(const QModelIndex &source_left, const QModelIndex &source_right) const
Devuelve ` true ` si el valor del elemento al que hace referencia el índice dado ` source_left ` es menor que el valor del elemento al que hace referencia el índice dado ` source_right`; en caso contrario, devuelve ` false`.
Esta función se utiliza como operator< al ordenar y emplea QAbstractItemModel::compareData().
La comparación de los « QString» distingue entre mayúsculas y minúsculas de forma predeterminada; esto se puede modificar mediante la propiedad « sortCaseSensitivity ».
Por defecto, se utiliza el « Qt::DisplayRole » asociado a los « QModelIndex» para las comparaciones. Esto se puede modificar configurando la propiedad « sortRole ».
Nota: Los índices que se pasan corresponden al modelo de origen.
Véanse también « sortRole », « sortCaseSensitivity » y « dynamicSortFilter ».
[override virtual] QModelIndex QSortFilterProxyModel::mapFromSource(const QModelIndex &sourceIndex) const
Reimplementa: ` QAbstractProxyModel::mapFromSource(const QModelIndex &sourceIndex) const`.
Devuelve el índice del modelo en ` QSortFilterProxyModel `, dado el ` sourceIndex ` del modelo de origen.
Véase también mapToSource().
[override virtual] QItemSelection QSortFilterProxyModel::mapSelectionFromSource(const QItemSelection &sourceSelection) const
Reimplementa: ` QAbstractProxyModel::mapSelectionFromSource` (`const QItemSelection &sourceSelection`) const.
[override virtual] QItemSelection QSortFilterProxyModel::mapSelectionToSource(const QItemSelection &proxySelection) const
Reimplementa: ` QAbstractProxyModel::mapSelectionToSource(const QItemSelection &proxySelection) const`.
[override virtual] QModelIndex QSortFilterProxyModel::mapToSource(const QModelIndex &proxyIndex) const
Reimplementa: QAbstractProxyModel::mapToSource(const QModelIndex &proxyIndex) const.
Devuelve el índice del modelo de origen correspondiente al proxyIndex dado, procedente del modelo de filtro de ordenación.
Véase también 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
Reimplementa: ` 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
Reimplementa: ` QAbstractProxyModel::mimeData(const QModelIndexList &indexes) const`.
[override virtual] QStringList QSortFilterProxyModel::mimeTypes() const
Reimplementa: ` QAbstractProxyModel::mimeTypes()` const.
[override virtual] QModelIndex QSortFilterProxyModel::parent(const QModelIndex &child) const
Reimplementa: ` QAbstractItemModel::parent(const QModelIndex &index) const`.
[signal] void QSortFilterProxyModel::recursiveFilteringEnabledChanged(bool recursiveFilteringEnabled)
Esta señal se emite cuando se modifica la configuración del filtro recursivo a « recursiveFilteringEnabled ».
Nota: Señalde notificación para la propiedad recursiveFilteringEnabled.
[override virtual] bool QSortFilterProxyModel::removeColumns(int column, int count, const QModelIndex &parent = QModelIndex())
Reimplementa: ` QAbstractItemModel::removeColumns` (int column, int count, const QModelIndex &parent).
[override virtual] bool QSortFilterProxyModel::removeRows(int row, int count, const QModelIndex &parent = QModelIndex())
Reimplementa: QAbstractItemModel::removeRows(int row, int count, const QModelIndex &parent).
[override virtual] int QSortFilterProxyModel::rowCount(const QModelIndex &parent = QModelIndex()) const
Reimplementa: ` QAbstractItemModel::rowCount(const QModelIndex &parent) const`.
[override virtual] bool QSortFilterProxyModel::setData(const QModelIndex &index, const QVariant &value, int role = Qt::EditRole)
Reimplementa: QAbstractProxyModel::setData(const QModelIndex &index, const QVariant &value, int role).
Véase también data().
[slot] void QSortFilterProxyModel::setFilterFixedString(const QString &pattern)
Establece la cadena fija utilizada para filtrar el contenido del modelo de origen en el valor indicado pattern.
Este método restablecerá las opciones de expresiones regulares, pero respetará la distinción entre mayúsculas y minúsculas.
Nota: Al llamar a este método se actualiza la expresión regular, lo que rompe el enlace de « filterRegularExpression ». Sin embargo, no afecta a los enlaces de « filterCaseSensitivity ».
Véase también setFilterCaseSensitivity(), setFilterRegularExpression(), setFilterWildcard() y filterRegularExpression().
[slot] void QSortFilterProxyModel::setFilterRegularExpression(const QString &pattern)
Establece la expresión regular utilizada para filtrar el contenido del modelo de origen en « pattern ».
Se recomienda utilizar este método en el código nuevo, ya que utilizará QRegularExpression internamente.
Este método restablecerá las opciones de la expresión regular, pero respetará la distinción entre mayúsculas y minúsculas.
Nota: Al llamar a este método se actualiza la expresión regular, lo que rompe el enlace de « filterRegularExpression ». Sin embargo, no afecta a los enlaces de « filterCaseSensitivity ».
Nota: Funciónsetter para la propiedad filterRegularExpression.
Nota: Esta ranura está sobrecargada. Para conectarse a esta ranura:
// 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); }); Véase también setFilterCaseSensitivity(), setFilterWildcard(), setFilterFixedString() y filterRegularExpression().
[slot] void QSortFilterProxyModel::setFilterWildcard(const QString &pattern)
Establece la expresión con comodines utilizada para filtrar el contenido del modelo de origen en la expresión « pattern » indicada.
Este método restablecerá las opciones de la expresión regular, pero respetará la distinción entre mayúsculas y minúsculas.
Nota: Al llamar a este método se actualiza la expresión regular, lo que rompe el enlace de filterRegularExpression. Sin embargo, no afecta a los enlaces de filterCaseSensitivity.
Véase también setFilterCaseSensitivity(), setFilterRegularExpression(), setFilterFixedString() y filterRegularExpression().
[override virtual] bool QSortFilterProxyModel::setHeaderData(int section, Qt::Orientation orientation, const QVariant &value, int role = Qt::EditRole)
Reimplementa: QAbstractProxyModel::setHeaderData(int section, Qt::Orientation orientation, const QVariant &value, int role).
Véase también headerData().
[override virtual] void QSortFilterProxyModel::setSourceModel(QAbstractItemModel *sourceModel)
Reimplementa: ` QAbstractProxyModel::setSourceModel(QAbstractItemModel *sourceModel)`.
[override virtual] QModelIndex QSortFilterProxyModel::sibling(int row, int column, const QModelIndex &idx) const
Reimplementa: QAbstractProxyModel::sibling(int row, int column, const QModelIndex &idx) const.
[override virtual] void QSortFilterProxyModel::sort(int column, Qt::SortOrder order = Qt::AscendingOrder)
Reimplementa: QAbstractProxyModel::sort(int column, Qt::SortOrder order).
Ordena el modelo según column en el order especificado. Si el orden column es menor que cero, el modelo se ordenará por fila del modelo de origen en el order especificado.
Véase también sortColumn().
[signal] void QSortFilterProxyModel::sortCaseSensitivityChanged(Qt::CaseSensitivity sortCaseSensitivity)
Esta señal se emite cuando la configuración de mayúsculas y minúsculas para la ordenación cambia a « sortCaseSensitivity ».
Nota: Señalde notificación para la propiedad « sortCaseSensitivity ».
int QSortFilterProxyModel::sortColumn() const
Devuelve la columna que se está utilizando actualmente para ordenar
Devuelve la columna de ordenación utilizada más recientemente. El valor por defecto es -1, lo que significa que este modelo proxy no ordena.
Véase también sort().
[signal] void QSortFilterProxyModel::sortLocaleAwareChanged(bool sortLocaleAware)
Esta señal se emite cuando la configuración de reconocimiento de la configuración regional cambia a « sortLocaleAware ».
Nota: Señalde notificación para la propiedad « isSortLocaleAware ».
Qt::SortOrder QSortFilterProxyModel::sortOrder() const
Devuelve el orden que se utiliza actualmente para ordenar
Devuelve el orden de clasificación utilizado más recientemente. El valor por defecto es Qt::AscendingOrder.
Véase también ` sort()`.
[signal] void QSortFilterProxyModel::sortRoleChanged(int sortRole)
Esta señal se emite cuando la función de ordenación cambia a « sortRole ».
Nota: Señalde notificación para la propiedad « sortRole ».
[override virtual] QSize QSortFilterProxyModel::span(const QModelIndex &index) const
Reimplementa: ` QAbstractProxyModel::span(const QModelIndex &index) const`.
[override virtual] Qt::DropActions QSortFilterProxyModel::supportedDropActions() const
Reimplementa: ` QAbstractProxyModel::supportedDropActions()` const.
© 2026 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.