ItemModelSurfaceDataProxy QML Type

Proxy-Klasse zur Darstellung von Daten in Item-Modellen mit „ Surface3D “. Mehr...

• Liste aller Mitglieder, einschließlich geerbter Mitglieder
• „ItemModelSurfaceDataProxy“ ist Teil von „Qt Graphs “ – QML-Typen für 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)

Ausführliche Beschreibung

Mit diesem Typ können Sie aus „ AbstractItemModel “ abgeleitete Modelle als Datenquelle für „ Surface3D “ verwenden.

Die Daten werden asynchron aufgelöst, sobald sich die Zuordnung oder das Modell ändert.

Informationen zu den Enums von „ItemModelSurfaceDataProxy“ finden Sie unter QItemModelSurfaceDataProxy::MultiMatchBehavior.

Weitere Informationen finden Sie in der Dokumentation zu „ QItemModelSurfaceDataProxy “.

Anwendungsbeispiel:

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 zu den Eigenschaften

autoColumnCategories : bool

Bei der Einstellung „ true “ ignoriert die Zuordnung alle explizit festgelegten Spaltenkategorien und überschreibt diese bei jeder Auflösung der Daten aus dem Modell durch automatisch generierte Kategorien. Auch die minimalen und maximalen Proxy-Spaltenwerte werden automatisch aus den Daten generiert, wenn diese Option auf „ true “ gesetzt ist. Die Standardeinstellung lautet „ true “.

autoRowCategories : bool

Bei der Einstellung „ true “ ignoriert die Zuordnung alle explizit festgelegten Zeilenkategorien und überschreibt diese bei jeder Auflösung der Daten aus dem Modell durch automatisch generierte Kategorien. Auch die minimalen und maximalen Proxy-Zeilenwerte werden automatisch aus den Daten generiert, wenn diese Option auf „ true “ gesetzt ist. Die Standardeinstellung lautet „ true “.

columnCategories : list<String>

Die Spaltenkategorien der Zuordnung. Bei der Datenauflösung werden nur Elemente mit Spaltenrollen berücksichtigt, die in dieser Liste aufgeführt sind. Die Spalten sind in derselben Reihenfolge angeordnet wie in dieser Liste.

columnRole : string

Die Rolle „Item-Modell“, die der Spaltenkategorie zugeordnet wird. Neben der Festlegung, 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, es ist zusätzlich eine separate X-Positionsrolle definiert.

columnRolePattern : regExp

Wenn diese Eigenschaft gesetzt ist, wird der durch die Spaltenrolle zugeordnete Wert vor seiner Verwendung als Spaltenkategorie durchsucht und ersetzt. Diese Eigenschaft legt den regulären Ausdruck fest, mit dem der zu ersetzende Teil des zugeordneten Werts gesucht wird, und die Eigenschaft „ columnRoleReplace “ enthält die Ersatzzeichenfolge.

Siehe auch „ columnRole “ und „ columnRoleReplace “.

columnRoleReplace : string

Der Ersatztext, der in Verbindung mit „ columnRolePattern “ verwendet werden soll. Der Standardwert ist eine leere Zeichenkette. Weitere Informationen zur Funktionsweise der Suche und des Ersetzens mit regulären Ausdrücken finden Sie in der Dokumentation zur 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 mit mehreren Übereinstimmungen für jede Zeilen-/Spaltenkombination verfahren wird. Die Standardeinstellung ist „ ItemModelSurfaceDataProxy.MultiMatchBehavior.Last “.

Beispielsweise könnten Sie ein Elementmodell mit zeitgestempelten Daten haben, die in unregelmäßigen Abständen erfasst wurden, und Sie möchten die durchschnittliche Position der Datenelemente pro Stunde mit einem Oberflächendiagramm visualisieren. Dies lässt sich erreichen, indem Sie Zeilen- und Spaltenkategorien so festlegen, dass jeder Punkt auf der Oberfläche eine Stunde darstellt, und „multiMatchBehavior“ auf „ ItemModelSurfaceDataProxy.MultiMatchBehavior.Average “ setzen.

rowCategories : list<String>

Die Zeilenkategorien der Zuordnung. Bei der Datenauflösung werden nur Elemente mit Zeilenrollen berücksichtigt, die in dieser Liste aufgeführt sind. Die Zeilen werden in derselben Reihenfolge sortiert, wie sie in dieser Liste stehen.

rowRole : string

Die Rolle „item“ des Modells wird der Zeilenkategorie zugeordnet. Der durch die Zeilenrolle angegebene Wert definiert nicht nur, zu welcher Zeile die Daten gehören, sondern wird bei der Auflösung der Modelldaten auch als Z-Koordinatenwert von „ QSurfaceDataItem “ festgelegt, sofern nicht zusätzlich eine eigene Z-Positionsrolle definiert ist.

rowRolePattern : regExp

Wenn diese Eigenschaft gesetzt ist, wird der durch die Zeilenrolle zugeordnete Wert vor seiner Verwendung als Zeilenkategorie einer Such- und Ersetzungsfunktion unterzogen. Diese Eigenschaft legt den regulären Ausdruck fest, mit dem der zu ersetzende Teil des zugeordneten Werts gesucht wird, und die Eigenschaft „ rowRoleReplace “ enthält die Ersetzungszeichenfolge.

Siehe auch „ rowRole “ und „ rowRoleReplace “.

rowRoleReplace : string

Der Ersatzinhalt, der in Verbindung mit „ rowRolePattern “ verwendet werden soll. Der Standardwert ist eine leere Zeichenkette. Weitere Informationen zur Funktionsweise der Suche und des Ersetzens mit regulären Ausdrücken finden Sie in der Dokumentation zur 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 aus dem Bereich „ QAbstractDataProxy::DataType “.

useModelCategories : bool

Bei der Einstellung „ true “ ignoriert die Zuordnung Zeilen- und Spaltenrollen sowie Kategorien und verwendet stattdessen die Zeilen und Spalten aus dem Modell. Die Standardeinstellung ist „ false “.

xPosRole : string

Die Rolle des Elementmodells, die der X-Position zugeordnet werden soll. Ist diese Rolle nicht definiert, wird „ columnRole “ verwendet, um den Wert der X-Koordinate der aufgelösten Elemente „ QSurfaceDataItem “ zu ermitteln.

xPosRolePattern : regExp

Wenn diese Eigenschaft gesetzt ist, wird der durch die Rolle „x-position“ zugeordnete Wert durchsucht und ersetzt, bevor er als Positionswert für ein Element verwendet wird. Diese Eigenschaft legt den regulären Ausdruck fest, mit dem der zu ersetzende Teil des zugeordneten Werts gesucht wird, und die Eigenschaft „ xPosRoleReplace “ enthält die Ersatzzeichenfolge.

Siehe auch „ xPosRole “ und „ xPosRoleReplace “.

xPosRoleReplace : string

Der Ersatzinhalt, der in Verbindung mit „ xPosRolePattern “ verwendet werden soll. Der Standardwert ist eine leere Zeichenkette. Weitere Informationen zur Funktionsweise der Suche und des Ersetzens mit regulären Ausdrücken finden Sie in der Dokumentation zur Funktion „ QString::replace “ (const QRegularExpression &rx, const QString &after).

Siehe auch „ xPosRole “ und „ xPosRolePattern “.

yPosRole : string

Die Rolle des Elementmodells, die der Y-Position zugeordnet werden soll.

yPosRolePattern : regExp

Wenn diese Eigenschaft gesetzt ist, wird der durch die Rolle „y-Position“ zugeordnete Wert durchsucht und ersetzt, bevor er als Positionswert für ein Element verwendet wird. Diese Eigenschaft gibt den regulären Ausdruck an, mit dem der zu ersetzende Teil des zugeordneten Werts gesucht wird, und die Eigenschaft „ yPosRoleReplace “ enthält die Ersetzungszeichenfolge.

Siehe auch „ yPosRole “ und „ yPosRoleReplace “.

yPosRoleReplace : string

Der Ersatzinhalt, der in Verbindung mit ` yPosRolePattern` verwendet werden soll. Der Standardwert ist eine leere Zeichenkette. Weitere Informationen zur Funktionsweise der Suche und des Ersetzens mit regulären Ausdrücken finden Sie in der Dokumentation zur Funktion ` QString::replace` (`const QRegularExpression &rx, const QString &after)`.

Siehe auch „ yPosRole “ und „ yPosRolePattern “.

zPosRole : string

Die Rolle des Elementmodells, die der Z-Position zugeordnet werden soll. Ist diese Rolle nicht definiert, wird „ rowRole “ verwendet, um den Wert der Z-Koordinate der aufgelösten Elemente „ QSurfaceDataItem “ zu ermitteln.

zPosRolePattern : regExp

Wenn diese Eigenschaft gesetzt ist, wird der durch die Rolle „z-position“ zugeordnete Wert vor seiner Verwendung als Elementpositionswert durchsucht und ersetzt. Diese Eigenschaft legt den regulären Ausdruck fest, mit dem der zu ersetzende Teil des zugeordneten Werts gesucht wird, und die Eigenschaft „ zPosRoleReplace “ enthält die Ersatzzeichenfolge.

Siehe auch „ zPosRole “ und „ zPosRoleReplace “.

zPosRoleReplace : string

Der Ersatzinhalt, der in Verbindung mit „ zPosRolePattern “ verwendet werden soll. Der Standardwert ist eine leere Zeichenkette. Weitere Informationen zur Funktionsweise der Suche und des Ersetzens mit regulären Ausdrücken finden Sie in der Dokumentation zur Funktion „ QString::replace “ (const QRegularExpression &rx, const QString &after).

Siehe auch „ zPosRole “ und „ zPosRolePattern “.

Signal-Dokumentation

autoColumnCategoriesChanged(bool enable)

Dieses Signal wird ausgelöst, wenn sich autoColumnCategories in enable ändert.

autoRowCategoriesChanged(bool enable)

Dieses Signal wird ausgelöst, wenn sich autoRowCategories in enable ändert.

columnCategoriesChanged()

Dieses Signal wird ausgelöst, wenn sich columnCategories ändert.

columnRoleChanged(string role)

Dieses Signal wird ausgelöst, wenn sich columnRole in role ändert.

columnRolePatternChanged(regExp pattern)

Dieses Signal wird ausgelöst, wenn sich „ columnRolePattern “ in „ pattern “ ändert.

columnRoleReplaceChanged(string replace)

Dieses Signal wird ausgelöst, wenn sich columnRoleReplace in replace ändert.

itemModelChanged(model itemModel)

Dieses Signal wird ausgelöst, wenn sich „ itemModel “ in „ itemModel “ ändert.

multiMatchBehaviorChanged(enumeration behavior)

Dieses Signal wird ausgelöst, wenn sich „ multiMatchBehavior “ in „ behavior “ ändert.

rowCategoriesChanged()

Dieses Signal wird ausgelöst, wenn sich rowCategories ändert.

rowRoleChanged(string role)

Dieses Signal wird ausgelöst, wenn sich rowRole in role ändert.

rowRolePatternChanged(regExp pattern)

Dieses Signal wird ausgelöst, wenn sich „ rowRolePattern “ in „ pattern “ ändert.

rowRoleReplaceChanged(string replace)

Dieses Signal wird ausgelöst, wenn sich „ rowRoleReplace “ in „ replace “ ändert.

useModelCategoriesChanged(bool enable)

Dieses Signal wird ausgelöst, wenn sich „ useModelCategories “ in „ enable “ ändert.

xPosRoleChanged(string role)

Dieses Signal wird ausgelöst, wenn sich „ xPosRole “ in „ role “ ändert.

xPosRolePatternChanged(regExp pattern)

Dieses Signal wird ausgelöst, wenn sich „ xPosRolePattern “ in „ pattern “ ändert.

xPosRoleReplaceChanged(string replace)

Dieses Signal wird ausgelöst, wenn sich xPosRoleReplace in replace ändert.

yPosRoleChanged(string role)

Dieses Signal wird ausgelöst, wenn sich „ yPosRole “ in „ role “ ändert.

yPosRolePatternChanged(regExp pattern)

Dieses Signal wird ausgelöst, wenn sich „ yPosRolePattern “ in „ pattern “ ändert.

yPosRoleReplaceChanged(string replace)

Dieses Signal wird ausgelöst, wenn sich „ yPosRoleReplace “ in „ replace “ ändert.

zPosRoleChanged(string role)

Dieses Signal wird ausgelöst, wenn sich „ zPosRole “ in „ role “ ändert.

zPosRolePatternChanged(regExp pattern)

Dieses Signal wird ausgelöst, wenn sich „ zPosRolePattern “ in „ pattern “ ändert.

zPosRoleReplaceChanged(string replace)

Dieses Signal wird ausgelöst, wenn sich „ zPosRoleReplace “ in „ replace “ ändert.