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 QtGraphs
In C++: QItemModelSurfaceDataProxy
Inherits:

SurfaceDataProxy

Eigenschaften

Signale

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 Graphs Datenverarbeitung mit 3D.

Dokumentation der Eigenschaft

autoColumnCategories : bool

Wenn diese Eigenschaft auf true gesetzt ist, 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 eingestellt 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, es sei denn, eine separate X-Positionsrolle ist ebenfalls definiert.


columnRolePattern : regExp

Wenn sie gesetzt ist, 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 Ersatzinhalt, 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 : enumeration

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

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.MultiMatchBehavior.Average.


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 Festlegung, 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, sofern nicht auch eine separate Z-Positionsrolle definiert ist.


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 Ersatzinhalt, der in Verbindung mit rowRolePattern 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 rowRole und rowRolePattern.


type : AbstractDataProxy.DataType [read-only]

Der Typ des Proxys. Einer der QAbstractDataProxy::DataType Werte.


useModelCategories : bool

Wenn er auf true gesetzt ist, ignoriert das Mapping 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 Positionswert 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 Ersatzinhalt, der in Verbindung mit xPosRolePattern 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 xPosRole und xPosRolePattern.


yPosRole : string

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


yPosRolePattern : regExp

Wenn diese Eigenschaft gesetzt ist, wird der Wert, der durch die Rolle y-position abgebildet wird, durchsucht 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 Ersatzinhalt, der in Verbindung mit yPosRolePattern 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 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 Wert, der durch die Rolle z-position zugeordnet wird, 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 Ersatzzeichenfolge.

Siehe auch zPosRole und zPosRoleReplace.


zPosRoleReplace : string

Der Ersatzinhalt, der in Verbindung mit zPosRolePattern 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 zPosRole und zPosRolePattern.


Signal-Dokumentation

autoColumnCategoriesChanged(bool enable)

Dieses Signal wird ausgegeben, wenn autoColumnCategories zu enable wechselt.

Hinweis: Der entsprechende Handler ist onAutoColumnCategoriesChanged.


autoRowCategoriesChanged(bool enable)

Dieses Signal wird ausgegeben, wenn autoRowCategories in enable wechselt.

Hinweis: Der entsprechende Handler ist onAutoRowCategoriesChanged.


columnCategoriesChanged()

Dieses Signal wird ausgegeben, wenn sich columnCategories ändert.

Hinweis: Der entsprechende Handler ist onColumnCategoriesChanged.


columnRoleChanged(string role)

Dieses Signal wird ausgegeben, wenn columnRole zu role wechselt.

Hinweis: Der entsprechende Handler ist onColumnRoleChanged.


columnRolePatternChanged(regExp pattern)

Dieses Signal wird ausgegeben, wenn columnRolePattern zu pattern wechselt.

Hinweis: Der entsprechende Handler ist onColumnRolePatternChanged.


columnRoleReplaceChanged(string replace)

Dieses Signal wird ausgegeben, wenn columnRoleReplace zu replace wechselt.

Hinweis: Der entsprechende Handler ist onColumnRoleReplaceChanged.


itemModelChanged(model itemModel)

Dieses Signal wird ausgegeben, wenn itemModel zu itemModel wechselt.

Hinweis: Der entsprechende Handler ist onItemModelChanged.


multiMatchBehaviorChanged(enumeration behavior)

Dieses Signal wird ausgegeben, wenn multiMatchBehavior zu behavior wechselt.

Hinweis: Der entsprechende Handler ist onMultiMatchBehaviorChanged.


rowCategoriesChanged()

Dieses Signal wird ausgegeben, wenn sich rowCategories ändert.

Hinweis: Der entsprechende Handler ist onRowCategoriesChanged.


rowRoleChanged(string role)

Dieses Signal wird ausgegeben, wenn rowRole zu role wechselt.

Hinweis: Der entsprechende Handler ist onRowRoleChanged.


rowRolePatternChanged(regExp pattern)

Dieses Signal wird ausgegeben, wenn rowRolePattern zu pattern wechselt.

Hinweis: Der entsprechende Handler ist onRowRolePatternChanged.


rowRoleReplaceChanged(string replace)

Dieses Signal wird ausgegeben, wenn rowRoleReplace zu replace wechselt.

Hinweis: Der entsprechende Handler ist onRowRoleReplaceChanged.


useModelCategoriesChanged(bool enable)

Dieses Signal wird ausgegeben, wenn useModelCategories zu enable wechselt.

Hinweis: Der entsprechende Handler ist onUseModelCategoriesChanged.


xPosRoleChanged(string role)

Dieses Signal wird ausgegeben, wenn xPosRole zu role wechselt.

Hinweis: Der entsprechende Handler ist onXPosRoleChanged.


xPosRolePatternChanged(regExp pattern)

Dieses Signal wird ausgegeben, wenn xPosRolePattern zu pattern wechselt.

Hinweis: Der entsprechende Handler ist onXPosRolePatternChanged.


xPosRoleReplaceChanged(string replace)

Dieses Signal wird ausgegeben, wenn xPosRoleReplace zu replace wechselt.

Hinweis: Der entsprechende Handler ist onXPosRoleReplaceChanged.


yPosRoleChanged(string role)

Dieses Signal wird ausgegeben, wenn yPosRole zu role wechselt.

Hinweis: Der entsprechende Handler ist onYPosRoleChanged.


yPosRolePatternChanged(regExp pattern)

Dieses Signal wird ausgegeben, wenn yPosRolePattern zu pattern wechselt.

Hinweis: Der entsprechende Handler ist onYPosRolePatternChanged.


yPosRoleReplaceChanged(string replace)

Dieses Signal wird ausgegeben, wenn yPosRoleReplace zu replace wechselt.

Hinweis: Der entsprechende Handler ist onYPosRoleReplaceChanged.


zPosRoleChanged(string role)

Dieses Signal wird ausgegeben, wenn zPosRole zu role wechselt.

Hinweis: Der entsprechende Handler ist onZPosRoleChanged.


zPosRolePatternChanged(regExp pattern)

Dieses Signal wird ausgegeben, wenn zPosRolePattern zu pattern wechselt.

Hinweis: Der entsprechende Handler ist onZPosRolePatternChanged.


zPosRoleReplaceChanged(string replace)

Dieses Signal wird ausgegeben, wenn zPosRoleReplace zu replace wechselt.

Hinweis: Der entsprechende Handler ist onZPosRoleReplaceChanged.


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