ItemModelSurfaceDataProxy QML Type

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

• Liste aller Mitglieder, einschließlich geerbter Mitglieder
• ItemModelSurfaceDataProxy ist Teil von Qt Graphs QML Types for 3D.

Eigenschaften

• autoColumnCategories : bool
• autoRowCategories : bool
• columnCategories : list<String>
• columnRole : string
• columnRolePattern : regExp
• columnRoleReplace : string
• itemModel : model
• multiMatchBehavior : enumeration
• rowCategories : list<String>
• rowRole : string
• rowRolePattern : regExp
• rowRoleReplace : string
• type : AbstractDataProxy.DataType
• useModelCategories : bool
• xPosRole : string
• xPosRolePattern : regExp
• xPosRoleReplace : string
• yPosRole : string
• yPosRolePattern : regExp
• yPosRoleReplace : string
• zPosRole : string
• zPosRolePattern : regExp
• zPosRoleReplace : string

Signale

• autoColumnCategoriesChanged(bool enable)
• autoRowCategoriesChanged(bool enable)
• columnCategoriesChanged()
• columnRoleChanged(string role)
• columnRolePatternChanged(regExp pattern)
• columnRoleReplaceChanged(string replace)
• itemModelChanged(model itemModel)
• multiMatchBehaviorChanged(enumeration behavior)
• rowCategoriesChanged()
• rowRoleChanged(string role)
• rowRolePatternChanged(regExp pattern)
• rowRoleReplaceChanged(string replace)
• useModelCategoriesChanged(bool enable)
• xPosRoleChanged(string role)
• xPosRolePatternChanged(regExp pattern)
• xPosRoleReplaceChanged(string replace)
• yPosRoleChanged(string role)
• yPosRolePatternChanged(regExp pattern)
• yPosRoleReplaceChanged(string replace)
• zPosRoleChanged(string role)
• zPosRolePatternChanged(regExp pattern)
• zPosRoleReplaceChanged(string replace)

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 Option auf true gesetzt ist, ignoriert das Mapping alle explizit gesetzten Spaltenkategorien und überschreibt sie mit automatisch generierten, sobald die Daten aus dem Modell aufgelöst werden. Proxy-Minimum- und -Maximum-Spaltenwerte werden ebenfalls automatisch aus den Daten generiert, wenn diese Option auf true gesetzt ist. Die Standardeinstellung ist true.

autoRowCategories : bool

Wenn diese Option auf true gesetzt ist, ignoriert die Zuordnung alle explizit gesetzten Zeilenkategorien und überschreibt sie mit automatisch generierten Kategorien, 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 enthalten 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. Es wird nicht nur festgelegt, zu welcher Spalte die Daten gehören, sondern der durch die Spaltenrolle angegebene Wert wird 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

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 Ersatzinhalt, der in Verbindung mit columnRolePattern verwendet wird. Der Standardwert ist eine leere Zeichenkette. 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 Artikelmodell, das als Datenquelle für Surface3D verwendet wird.

multiMatchBehavior : enumeration

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

Sie könnten beispielsweise ein Elementmodell mit zeitgestempelten Daten haben, die in unregelmäßigen Abständen erfasst werden, und Sie möchten die durchschnittliche Position der Datenelemente in jeder Stunde mit einem Oberflächendiagramm visualisieren. 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 zu finden 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. Es wird nicht nur festgelegt, zu welcher Zeile die Daten gehören, sondern der durch die Zeilenrolle angegebene Wert wird 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 von der 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 Zeichenkette. 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 Werte QAbstractDataProxy::DataType.

useModelCategories : bool

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

xPosRole : string

Die Elementmodellrolle, 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 gesetzt ist, wird der Wert, der durch die Rolle x-position zugeordnet wurde, 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 Ersatzzeichenfolge.

Siehe auch xPosRole und xPosRoleReplace.

xPosRoleReplace : string

Der Ersatzinhalt, der in Verbindung mit xPosRolePattern verwendet wird. Der Standardwert ist eine leere Zeichenkette. 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 Rolle des Positionsmodells, die der Y-Position zugeordnet werden soll.

yPosRolePattern : regExp

Wenn diese Eigenschaft gesetzt ist, wird der Wert, der durch die Rolle y-position zugeordnet wurde, 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 Ersatzzeichenfolge.

Siehe auch yPosRole und yPosRoleReplace.

yPosRoleReplace : string

Der Ersatzinhalt, der in Verbindung mit yPosRolePattern verwendet wird. Der Standardwert ist eine leere Zeichenkette. 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 gesetzt ist, wird der Wert, der durch die Rolle z-position zugeordnet ist, 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 Zeichenkette. 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.

autoRowCategoriesChanged(bool enable)

Dieses Signal wird ausgegeben, wenn autoRowCategories zu enable wechselt.

columnCategoriesChanged()

Dieses Signal wird ausgegeben, wenn sich columnCategories ändert.

columnRoleChanged(string role)

Dieses Signal wird ausgegeben, wenn columnRole zu role wechselt.

columnRolePatternChanged(regExp pattern)

Dieses Signal wird ausgegeben, wenn columnRolePattern zu pattern wechselt.

columnRoleReplaceChanged(string replace)

Dieses Signal wird ausgegeben, wenn columnRoleReplace zu replace wechselt.

itemModelChanged(model itemModel)

Dieses Signal wird ausgegeben, wenn itemModel zu itemModel wechselt.

multiMatchBehaviorChanged(enumeration behavior)

Dieses Signal wird ausgegeben, wenn multiMatchBehavior zu behavior wechselt.

rowCategoriesChanged()

Dieses Signal wird ausgegeben, wenn sich rowCategories ändert.

rowRoleChanged(string role)

Dieses Signal wird ausgegeben, wenn rowRole zu role wechselt.

rowRolePatternChanged(regExp pattern)

Dieses Signal wird ausgegeben, wenn rowRolePattern zu pattern wechselt.

rowRoleReplaceChanged(string replace)

Dieses Signal wird ausgegeben, wenn rowRoleReplace zu replace wechselt.

useModelCategoriesChanged(bool enable)

Dieses Signal wird ausgegeben, wenn useModelCategories zu enable wechselt.

xPosRoleChanged(string role)

Dieses Signal wird ausgegeben, wenn xPosRole zu role wechselt.

xPosRolePatternChanged(regExp pattern)

Dieses Signal wird ausgegeben, wenn xPosRolePattern zu pattern wechselt.

xPosRoleReplaceChanged(string replace)

Dieses Signal wird ausgegeben, wenn xPosRoleReplace zu replace wechselt.

yPosRoleChanged(string role)

Dieses Signal wird ausgegeben, wenn yPosRole zu role wechselt.

yPosRolePatternChanged(regExp pattern)

Dieses Signal wird ausgegeben, wenn yPosRolePattern zu pattern wechselt.

yPosRoleReplaceChanged(string replace)

Dieses Signal wird ausgegeben, wenn yPosRoleReplace zu replace wechselt.

zPosRoleChanged(string role)

Dieses Signal wird ausgegeben, wenn zPosRole zu role wechselt.

zPosRolePatternChanged(regExp pattern)

Dieses Signal wird ausgegeben, wenn zPosRolePattern zu pattern wechselt.

zPosRoleReplaceChanged(string replace)

Dieses Signal wird ausgegeben, wenn zPosRoleReplace zu replace wechselt.