En esta página

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

Métodos

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.