ItemModelSurfaceDataProxy QML Type

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

Dieser Typ ist veraltet. Wir raten dringend davon ab, ihn in neuem Code zu verwenden.

• Liste aller Mitglieder, einschließlich geerbter Mitglieder

Eigenschaften

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

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 das Mapping 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 Data Visualization – Datenverarbeitung“.

Eigenschaftsdokumentation

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 Mindest- und Höchstwerte der Proxy-Spalten 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 durch automatisch generierte, sobald die Daten aus dem Modell aufgelöst werden. 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 bei der Auflösung der Modelldaten auch als X-Koordinatenwert von `QSurfaceDataItem` festgelegt, sofern nicht zusätzlich eine separate X-Positionsrolle definiert ist.

columnRolePattern : regExp

Wenn diese Eigenschaft gesetzt ist, wird der durch die Spaltenrolle zugeordnete Wert einer Such- und Ersetzungsoperation unterzogen, bevor er als Spaltenkategorie verwendet wird. 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 zu ersetzende Inhalt, der in Verbindung mit ` columnRolePattern` verwendet werden soll. Standardmäßig ist dies eine leere Zeichenfolge. Weitere Informationen zur Funktionsweise des Suchens und 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 Objektmodell, das als Datenquelle für Surface3D verwendet wird.

multiMatchBehavior : ItemModelSurfaceDataProxy.MultiMatchBehavior

Legt fest, wie mit mehreren Übereinstimmungen für jede Zeilen-/Spaltenkombination verfahren wird. Die Standardeinstellung lautet „ ItemModelSurfaceDataProxy.MMBLast “.

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 kann erreicht werden, indem Sie Zeilen- und Spaltenkategorien so festlegen, dass jeder Punkt auf der Oberfläche eine Stunde darstellt, und „multiMatchBehavior“ auf „ ItemModelSurfaceDataProxy.MMBAverage “ 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 erscheinen.

rowRole : string

Die Rolle „Item“ des Modells, die der Zeilenkategorie zugeordnet werden soll. Die durch die Zeilenrolle angegebene Zahl legt nicht nur fest, zu welcher Zeile die Daten gehören, sondern wird bei der Auflösung der Modelldaten auch als Z-Koordinatenwert von `QSurfaceDataItem` verwendet, 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 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 „ rowRoleReplace “ enthält die Ersatzzeichenfolge.

Siehe auch „ rowRole “ und „ rowRoleReplace “.

rowRoleReplace : string

Der zu ersetzende Inhalt, der in Verbindung mit ` rowRolePattern` verwendet wird. Standardmäßig ist dies 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 “.

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 Elementpositionswert verwendet wird. Diese Eigenschaft gibt den regulären Ausdruck an, 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 zu ersetzende Inhalt, der in Verbindung mit ` xPosRolePattern` verwendet wird. 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 vor seiner Verwendung als Elementpositionswert durchsucht und ersetzt. 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 Ersatzzeichenfolge.

Siehe auch „ yPosRole “ und „ yPosRoleReplace “.

yPosRoleReplace : string

Der zu ersetzende Inhalt, der in Verbindung mit yPosRolePattern verwendet wird. Der Standardwert ist eine leere Zeichenkette. Weitere Informationen zur Funktionsweise des Suchens und 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 gibt den regulären Ausdruck an, 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 zu ersetzende Inhalt, der in Verbindung mit ` zPosRolePattern` verwendet wird. 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 “.