SortFilterProxyModel QML Type
Ofrece funciones de ordenación y filtrado para un QAbstractItemModel. Más información...
| Import Statement: | import QtQml.Models |
| Since: | Qt 6.10 |
| Status: | Technology preview |
Este tipo se encuentra en fase de vista previa tecnológica y está sujeto a cambios.
Propiedades
- autoAcceptChildRows : bool
- dynamicSortFilter : bool
- filters : list<FilterBase>
- recursiveFiltering : bool
- sorters : list<Sorter>
- sourceModel : var
Métodos
- void invalidate()
- void invalidateSorter()
- void setPrimarySorter(sorter)
Descripción detallada
SortFilterProxyModel hereda de QAbstractProxyModel, que se encarga de la transformación de los índices de origen en índices proxy. La ordenación y el filtrado se controlan mediante las propiedades sorters y filters, que determinan el orden de ejecución tal y como se especifica en QML. Este orden puede anularse utilizando la propiedad priority disponible para cada ordenador. Por defecto, todos los ordenadores comparten la misma prioridad.
SortFilterProxyModel permite a los usuarios ordenar y filtrar un QAbstractItemModel. Las vistas de elementos, como TableView o TreeView, pueden utilizar este modelo proxy para mostrar contenido filtrado.
Nota: Actualmente , SortFilterProxyModel solo admite QAbstractItemModel como modelo de origen.
El fragmento de código siguiente muestra la configuración de los ordenadores y filtros en el SortFilterProxyModel de QML:
ProcessModel { id: processModel }
SortFilterProxyModel {
id: sfpm
sourceModel: processModel
sorters: [
RoleSorter {
roleName: "user"
priority: 0
},
RoleSorter {
roleName: "pid"
priority: 1
}
]
filters: [
FunctionFilter {
function filter(cpuUsage: real) : bool {
return (cpuUsage > 90)
}
}
]
}El SortFilterProxyModel ordena y filtra los datos de forma dinámica cada vez que se produce un cambio en los datos del modelo de origen y puede desactivarse mediante la propiedad dynamicSortFilter.
Los ordenadores « RoleSorter », « StringSorter » y « FunctionSorter » se pueden configurar en SortFilterProxyModel. Cada ordenador se puede configurar con un índice de columna específico mediante la propiedad « column ». Si no se especifica un índice de columna, la ordenación se aplicará por defecto al índice de columna 0 del modelo. El orden de ejecución del clasificador se puede modificar mediante la propiedad « priority ». Esto resulta especialmente útil al realizar una ordenación jerárquica, como ordenar los datos de la primera columna y, a continuación, aplicar la ordenación a las columnas siguientes.
Para desactivar un clasificador específico, se puede establecer ` enabled ` en ` false`.
La prioridad del clasificador también se puede anular estableciendo el clasificador principal mediante la llamada al método ` setPrimarySorter()`. Esto resultaría útil en el caso de que la vista quiera ordenar los datos de cualquier columna específica al hacer clic en el encabezado de la columna, como en TableView, cuando también hay otros clasificadores configurados para el modelo.
Los filtros ValueFilter y FunctionFilter pueden configurarse en SortFilterProxyModel. Cada filtro puede configurarse con la propiedad column, de forma similar al clasificador, para filtrar los datos de una columna específica. Si no se especifica ninguna columna, el filtro se aplicará a todos los índices de columna del modelo. Para reducir la sobrecarga de comprobaciones innecesarias durante el filtrado, se recomienda especificar el índice de columna.
Para desactivar un filtro específico, se puede establecer ` enabled ` en ` false`.
ListModel {
id: listModel
ListElement { name: "Adan"; age: 25; department: "Process"; pid: 209711; country: "Norway" }
ListElement { name: "Hannah"; age: 48; department: "HR"; pid: 154916; country: "Germany" }
ListElement { name: "Divina"; age: 63; department: "Marketing"; pid: 158038; country: "Spain" }
ListElement { name: "Rohith"; age: 35; department: "Process"; pid: 202582; country: "India" }
ListElement { name: "Latesha"; age: 23; department: "Quality"; pid: 232582; country: "UK" }
}
SortFilterProxyModel {
id: ageFilterModel
sourceModel: listModel
filters: [
AgeFilter { }
]
sorters: [
RoleSorter { roleName: "department" }
]
}
ListView {
anchors.fill: parent
clip: true
model: ageFilterModel
delegate: Rectangle {
implicitWidth: 100
implicitHeight: 50
border.width: 1
Text {
text: name
anchors.centerIn: parent
}
}
}El AgeFilter del fragmento de código anterior se puede declarar de la siguiente manera
FunctionFilter {
function filter(age: int) : bool {
return age > 30
}
}Nota: Esta API se considera una vista previa técnica y puede cambiar o eliminarse en futuras versiones de Qt.
Documentación de la propiedad
autoAcceptChildRows : bool
Esta propiedad no filtrará las filas secundarias de las filas aceptadas. El comportamiento es similar al de «autoAcceptChildRows» en QSortFilterProxyModel.
El valor por defecto es false.
dynamicSortFilter : bool
Esta propiedad determina si el modelo proxy se ordena y se filtra dinámicamente cada vez que cambia el contenido del modelo de origen.
El valor por defecto es « true ».
filters : list<FilterBase>
Esta propiedad contiene la lista de filtros para el « SortFilterProxyModel ». Si no se establece ninguna prioridad, el « SortFilterProxyModel » aplica los filtros en el orden especificado en la lista.
recursiveFiltering : bool
Esta propiedad permite aplicar de forma recursiva todos los filtros configurados a los elementos secundarios. El comportamiento es similar al de « recursiveFilteringEnabled » en QSortFilterProxyModel.
El valor por defecto es « false ».
sorters : list<Sorter>
Esta propiedad contiene la lista de clasificadores para el ` SortFilterProxyModel`. Si no se establece ninguna prioridad, el ` SortFilterProxyModel ` aplica un clasificador en el orden especificado en la lista.
sourceModel : var
Esta propiedad permite establecer el modelo de origen para el modelo proxy del filtro de ordenación. El valor debe ser del tipo « QAbstractItemModel ».
Documentación del método
void invalidate()
Este método invalida el modelo al volver a evaluar los filtros y criterios de ordenación configurados en los datos del modelo de origen.
void invalidateSorter()
Este método obliga al modelo proxy del filtro de ordenación a volver a evaluar los ordenadores configurados en función de los datos. Se puede utilizar en los casos en los que se haya desactivado la ordenación dinámica mediante la propiedad dynamicSortFilter
void setPrimarySorter(sorter)
Este método permite establecer el clasificador principal en el modelo de proxy del filtro de clasificación. El clasificador principal se evaluará antes que cualquier otro clasificador configurado como parte de la propiedad ` sorter `. Si no se configura ni se pasa a ` null`, se considerará como clasificador principal aquel que tenga mayor prioridad.
© 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.