Back to Qt.io
Contact Us Blog Download Qt

ItemModelSurfaceDataProxy QML Type

Proxy-Klasse zur Darstellung von Daten in Artikelmodellen mit Surface3D. Mehr...

Import Statement: import QtDataVisualization 1.8
Since: QtDataVisualization 1.0
In C++: QItemModelSurfaceDataProxy
Inherits:

SurfaceDataProxy

Eigenschaften

Detaillierte Beschreibung

Dieser Typ ermöglicht es Ihnen, AbstractItemModel abgeleitete Modelle als Datenquelle für Surface3D zu verwenden.

Die Daten werden asynchron aufgelöst, wenn sich das Mapping oder das Modell ändert.

Für ItemModelSurfaceDataProxy enums, siehe QItemModelSurfaceDataProxy::MultiMatchBehavior.

Weitere Details finden Sie in der Dokumentation QItemModelSurfaceDataProxy.

Beispiel für die Verwendung:

ItemModelSurfaceDataProxy {
    itemModel: model // E.g. a list model defined elsewhere containing population data.
    // Mapping model roles to surface series rows, columns, and values.
    rowRole: "longitude"
    columnRole: "latitude"
    valueRole: "pop_density"
}

Siehe auch SurfaceDataProxy und Qt Data Visualization Data Handling.

Dokumentation der Eigenschaft

autoColumnCategories : bool

Wenn auf true gesetzt, ignoriert das Mapping alle explizit gesetzten Spaltenkategorien und überschreibt sie mit automatisch generierten, wenn die Daten aus dem Modell aufgelöst werden. Proxy-Minimum- und -Maximum-Spaltenwerte werden ebenfalls automatisch aus den Daten generiert, wenn diese Eigenschaft auf true gesetzt ist. Die Standardeinstellung ist true.


autoRowCategories : bool

Bei der Einstellung true ignoriert das Mapping alle explizit gesetzten Zeilenkategorien und überschreibt sie mit automatisch generierten, wenn die Daten aus dem Modell aufgelöst werden. Proxy-Minimum- und -Maximum-Zeilenwerte werden ebenfalls automatisch aus den Daten generiert, wenn diese Option auf true gesetzt ist. Die Standardeinstellung ist true.


columnCategories : list<String>

Die Spaltenkategorien der Zuordnung. Nur Elemente mit Spaltenrollen, die in dieser Liste zu finden sind, werden bei der Datenauflösung berücksichtigt. Die Spalten werden in der gleichen Reihenfolge wie in dieser Liste angeordnet.


columnRole : string

Die Elementmodellrolle, die der Spaltenkategorie zugeordnet werden soll. Zusätzlich zur Definition, zu welcher Spalte die Daten gehören, wird der durch die Spaltenrolle angegebene Wert auch als X-Koordinatenwert von QSurfaceDataItem festgelegt, wenn die Modelldaten aufgelöst werden, sofern nicht auch eine separate X-Positionsrolle definiert ist.


columnRolePattern : regExp

Ist diese Eigenschaft gesetzt, wird der durch die Spaltenrolle zugeordnete Wert gesucht und ersetzt, bevor er als Spaltenkategorie verwendet wird. Diese Eigenschaft gibt den regulären Ausdruck an, um den zu ersetzenden Teil des zugeordneten Wertes zu finden, und die Eigenschaft columnRoleReplace enthält die Ersetzungszeichenfolge.

Siehe auch columnRole und columnRoleReplace.


columnRoleReplace : string

Der Ersetzungsinhalt, der in Verbindung mit columnRolePattern verwendet wird. Der Standardwert ist eine leere Zeichenfolge. Weitere Informationen darüber, wie das Suchen und Ersetzen mit regulären Ausdrücken funktioniert, finden Sie in der Dokumentation der Funktion QString::replace(const QRegularExpression &rx, const QString &after).

Siehe auch columnRole und columnRolePattern.


itemModel : model

Das Elementmodell, das als Datenquelle für Surface3D verwendet wird.


multiMatchBehavior : ItemModelSurfaceDataProxy.MultiMatchBehavior

Legt fest, wie mehrere Übereinstimmungen für jede Zeilen-/Spaltenkombination behandelt werden. Der Standardwert ist ItemModelSurfaceDataProxy.MMBLast.

Sie haben beispielsweise ein Objektmodell mit zeitgestempelten Daten, die in unregelmäßigen Abständen erfasst werden, und möchten die durchschnittliche Position der Datenelemente zu jeder Stunde in einem Oberflächendiagramm darstellen. Dazu geben Sie Zeilen- und Spaltenkategorien an, so dass jeder Oberflächenpunkt eine Stunde darstellt, und setzen multiMatchBehavior auf ItemModelSurfaceDataProxy.MMBAverage.


rowCategories : list<String>

Die Zeilenkategorien des Mappings. Nur Elemente mit Zeilenrollen, die in dieser Liste enthalten sind, werden bei der Datenauflösung berücksichtigt. Die Zeilen werden in der gleichen Reihenfolge wie in dieser Liste angeordnet.


rowRole : string

Die Elementmodellrolle, die der Zeilenkategorie zugeordnet werden soll. Zusätzlich zur Definition, zu welcher Zeile die Daten gehören, wird der durch die Zeilenrolle angegebene Wert auch als Z-Koordinatenwert von QSurfaceDataItem festgelegt, wenn die Modelldaten aufgelöst werden, es sei denn, eine separate Z-Positionsrolle ist ebenfalls definiert.


rowRolePattern : regExp

Wenn diese Eigenschaft gesetzt ist, wird der durch die Zeilenrolle zugeordnete Wert gesucht und ersetzt, bevor er als Zeilenkategorie verwendet wird. Diese Eigenschaft gibt den regulären Ausdruck an, um den zu ersetzenden Teil des zugeordneten Wertes zu finden, und die Eigenschaft rowRoleReplace enthält die Ersetzungszeichenfolge.

Siehe auch rowRole und rowRoleReplace.


rowRoleReplace : string

Der zu ersetzende Inhalt wird in Verbindung mit rowRolePattern verwendet. Der Standardwert ist eine leere Zeichenfolge. Weitere Informationen darüber, wie das Suchen und Ersetzen mit regulären Ausdrücken funktioniert, finden Sie in der Dokumentation der Funktion QString::replace(const QRegularExpression &rx, const QString &after).

Siehe auch rowRole und rowRolePattern.


useModelCategories : bool

Bei der Einstellung true ignoriert die Zuordnung die Zeilen- und Spaltenrollen und -kategorien und verwendet stattdessen die Zeilen und Spalten aus dem Modell. Der Standardwert ist false.


xPosRole : string

Die Artikelmodellrolle, die der X-Position zugeordnet werden soll. Wenn diese Rolle nicht definiert ist, wird columnRole verwendet, um den X-Koordinatenwert der aufgelösten QSurfaceDataItem Elemente zu bestimmen.


xPosRolePattern : regExp

Wenn diese Eigenschaft festgelegt ist, wird der durch die X-Position-Rolle zugeordnete Wert gesucht und ersetzt, bevor er als Elementpositionswert verwendet wird. Diese Eigenschaft gibt den regulären Ausdruck an, um den zu ersetzenden Teil des zugeordneten Wertes zu finden, und die Eigenschaft xPosRoleReplace enthält die Ersetzungszeichenfolge.

Siehe auch xPosRole und xPosRoleReplace.


xPosRoleReplace : string

Der zu ersetzende Inhalt wird in Verbindung mit xPosRolePattern verwendet. Der Standardwert ist eine leere Zeichenfolge. Weitere Informationen darüber, wie das Suchen und Ersetzen mit regulären Ausdrücken funktioniert, finden Sie in der Dokumentation der Funktion QString::replace(const QRegularExpression &rx, const QString &after).

Siehe auch xPosRole und xPosRolePattern.


yPosRole : string

Die Elementmodellrolle, die der Y-Position zugeordnet werden soll.


yPosRolePattern : regExp

Wenn diese Eigenschaft gesetzt ist, wird der durch die y-Position-Rolle zugeordnete Wert gesucht und ersetzt, bevor er als Positionswert verwendet wird. Diese Eigenschaft gibt den regulären Ausdruck an, um den zu ersetzenden Teil des zugeordneten Wertes zu finden, und die Eigenschaft yPosRoleReplace enthält die Ersetzungszeichenfolge.

Siehe auch yPosRole und yPosRoleReplace.


yPosRoleReplace : string

Der zu ersetzende Inhalt wird in Verbindung mit yPosRolePattern verwendet. Der Standardwert ist eine leere Zeichenfolge. Weitere Informationen darüber, wie das Suchen und Ersetzen mit regulären Ausdrücken funktioniert, finden Sie in der Dokumentation der Funktion QString::replace(const QRegularExpression &rx, const QString &after).

Siehe auch yPosRole und yPosRolePattern.


zPosRole : string

Die Elementmodellrolle, die der Z-Position zugeordnet werden soll. Wenn diese Rolle nicht definiert ist, wird rowRole verwendet, um den Z-Koordinatenwert der aufgelösten QSurfaceDataItem Elemente zu bestimmen.


zPosRolePattern : regExp

Wenn diese Eigenschaft festgelegt ist, wird der durch die Z-Position-Rolle zugeordnete Wert gesucht und ersetzt, bevor er als Positionswert verwendet wird. Diese Eigenschaft gibt den regulären Ausdruck an, um den zu ersetzenden Teil des zugeordneten Wertes zu finden, und die Eigenschaft zPosRoleReplace enthält die Ersetzungszeichenfolge.

Siehe auch zPosRole und zPosRoleReplace.


zPosRoleReplace : string

Der zu ersetzende Inhalt wird in Verbindung mit zPosRolePattern verwendet. Der Standardwert ist eine leere Zeichenfolge. Weitere Informationen darüber, wie das Suchen und Ersetzen mit regulären Ausdrücken funktioniert, finden Sie in der Dokumentation der Funktion QString::replace(const QRegularExpression &rx, const QString &after).

Siehe auch zPosRole und zPosRolePattern.


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