En esta página

FunctionSorter QML Type

Ordena los datos de un ` SortFilterProxyModel ` basándose en la evaluación del método «compare» designado. Más...

Import Statement: import QtQml.Models
Since: Qt 6.10
Inherits:

Sorter

Status: Deprecated since 6.12

Este tipo está obsoleto desde QtQml.Models 6.12. Recomendamos encarecidamente no utilizarlo en código nuevo.

Descripción detallada

FunctionSorter permite al usuario definir el método «compare» designado, que se evaluará para ordenar los datos. El método toma dos argumentos (lhs y rhs) del tipo de parámetro especificado y se puede acceder a los datos como se indica a continuación para su evaluación:

SortFilterProxyModel {
    sourceModel: model
    sorters: [
        FunctionSorter {
            id: functionSorter
            component RoleData: QtObject {
                property real age
            }
            function compare(lhsData: RoleData, rhsData: RoleData) : int {
                return (lhsData.age < rhsData.age) ? -1 : ((lhsData === rhsData.age) ? 0 : 1)
            }
        }
    ]
}

Advertencia: Ambos parámetros del método « compare » deben llevar una anotación de tipo explícita, tal y como se hace en lhsData y rhsData en el ejemplo anterior, y ambas anotaciones deben resolverse en el mismo tipo. El método compare, escrito al estilo habitual de JavaScript, sin anotaciones de tipo de parámetro, p. ej., function compare(lhsData, rhsData) : int { ... }, se compila sin ninguna advertencia, pero falla en la comparación. FunctionSorter se basa en el tipo anotado para saber qué tipo de objeto «role-data» debe instanciar y rellenar para lhsData y rhsData; sin él, no hay nada que instanciar.

Nota: El método ` sort ` está obsoleto. Cámbiale el nombre a ` compare`.

Nota: La función ` compare ` debe tener exactamente dos parámetros con anotaciones de tipo explícitas de tipos coincidentes y un tipo de retorno explícito ` : int `. Si no se cumplen estos requisitos, el clasificador emite una advertencia y finaliza prematuramente.

Nota: El usuario debe invocar explícitamente ` SortFilterProxyModel::invalidateSorter ` cada vez que cambie cualquier propiedad QML externa utilizada dentro del método «compare» designado. Este comportamiento está sujeto a cambios en el futuro, como la invalidación implícita, por lo que el usuario no tendrá que invocar explícitamente ` SortFilterProxyModel::invalidateSorter`.

© 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.