SortFilterProxyModel QML Type

Bietet Sortier- und Filtermöglichkeiten für eine QAbstractItemModel. Mehr....

Dieser Typ befindet sich in der Entwicklung und kann sich noch ändern.

• Liste aller Mitglieder, einschließlich geerbter Mitglieder

Eigenschaften

• autoAcceptChildRows : bool
• dynamicSortFilter : bool
• filters : list<Filter>
• model : var
• recursiveFiltering : bool
• sorters : list<Sorter>

Methoden

• invalidate()
• invalidateSorter()
• setPrimarySorter(sorter)

Detaillierte Beschreibung

SortFilterProxyModel erbt von QAbstractProxyModel, das die Umwandlung von Quellindizes in Proxy-Indizes übernimmt. Sortierung und Filterung werden über die Eigenschaften sorters und filters gesteuert, die die in QML festgelegte Reihenfolge der Ausführung bestimmen. Diese Reihenfolge kann mit der Eigenschaft priority, die für jeden Sortierer verfügbar ist, außer Kraft gesetzt werden. Standardmäßig haben alle Sortierer die gleiche Priorität.

Mit SortFilterProxyModel können Benutzer ein QAbstractItemModel sortieren und filtern. Die Elementansichten wie TableView oder TreeView können dieses Proxy-Modell verwenden, um gefilterte Inhalte anzuzeigen.

Das folgende Snippet zeigt die Konfiguration von Sortierern und Filtern im QML SortFilterProxyModel:

ProcessModel { id: processModel }

SortFilterProxyModel {
    id: sfpm
    model: processModel
    sorters: [
        RoleSorter: {
            roleName: "user"
            priority: 0
        },
        RoleSorter: {
            roleName: "pid"
            priority: 1
        }
    ]
    filters: [
        FunctionFilter: {
            component RoleData: QtObject { property qreal cpuUsage }
            function filter(data: RoleData) : bool {
                return (data.cpuUsage > 90)
            }
        }
    ]
}

Das SortFilterProxyModel sortiert und filtert Daten dynamisch, sobald sich die Daten im Quellmodell ändern und kann über die Eigenschaft dynamicSortFilter deaktiviert werden.

Die Sortierer RoleSorter, StringSorter und FunctionSorter können in SortFilterProxyModel konfiguriert werden. Jeder Sortierer kann mit einem bestimmten Spaltenindex über die Eigenschaft column konfiguriert werden. Wenn kein Spaltenindex angegeben wird, wird die Sortierung standardmäßig auf den Spaltenindex 0 des Modells angewendet. Die Ausführungsreihenfolge des Sortierers kann über die Eigenschaft priority geändert werden. Dies ist besonders nützlich, wenn eine hierarchische Sortierung durchgeführt wird, wie z. B. die Sortierung von Daten in der ersten Spalte und die anschließende Anwendung der Sortierung auf die nachfolgenden Spalten.

Um einen bestimmten Sortierer zu deaktivieren, kann enabled auf false gesetzt werden.

Die Sortierpriorität kann auch außer Kraft gesetzt werden, indem der primäre Sortierer durch den Methodenaufruf setPrimarySorter festgelegt wird. Dies wäre hilfreich, wenn die Ansicht die Daten einer bestimmten Spalte sortieren möchte, indem sie auf die Spaltenüberschrift klickt, wie z. B. in TableView, wenn auch andere Sortierer für das Modell konfiguriert sind.

Die Filter ValueFilter und FunctionFilter können im SortFilterProxyModel konfiguriert werden. Jeder Filter kann mit der Eigenschaft column eingestellt werden, ähnlich wie der Sortierer, um Daten in einer bestimmten Spalte zu filtern. Wenn keine Spalte angegeben wird, wird der Filter auf alle Spaltenindizes im Modell angewendet. Um den Overhead von unerwünschten Überprüfungen während des Filterns zu reduzieren, ist es empfehlenswert, den Spaltenindex anzugeben.

Um einen bestimmten Filter zu deaktivieren, kann enabled auf false gesetzt werden.

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
    model: listModel
    filters: [
        FunctionFilter {
            roleData: QtObject { property int age }
            function filter(data: QtObject) : bool {
                return data.age > 30
            }
        }
    ]
    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
        }
    }
}

Dokumentation der Eigenschaft

Methode Dokumentation