QItemModelSurfaceDataProxy Class

QItemModelSurfaceDataProxy *proxy = new QItemModelSurfaceDataProxy(customModel,
                                                                   QStringLiteral("longitude"), // Row role
                                                                   QStringLiteral("latitude"), // Column role
                                                                   QStringLiteral("height")); // Y-position role

Dokumentation zu den Eigenschaften

autoColumnCategories : bool

Diese Eigenschaft legt fest, ob Spaltenkategorien automatisch generiert werden.

Bei der Einstellung „ true “ ignoriert das Mapping alle explizit festgelegten Spaltenkategorien und überschreibt diese bei jeder Auflösung der Daten aus dem Modell durch automatisch generierte Kategorien. Die Standardeinstellung ist „ true “.

Zugriffsfunktionen:

Benachrichtigungssignal:

autoRowCategories : bool

Diese Eigenschaft legt fest, ob Zeilenkategorien automatisch generiert werden.

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. Die Standardeinstellung lautet „ true “.

Zugriffsfunktionen:

Benachrichtigungssignal:

columnCategories : QStringList

Diese Eigenschaft enthält die Spaltenkategorien für die Zuordnung.

Zugriffsfunktionen:

Benachrichtigungssignal:

columnRole : QString

Diese Eigenschaft enthält die Rolle des Elementmodells, die der Spaltenkategorie zugeordnet werden soll.

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 Modelldaten aufgelöst werden, sofern nicht zusätzlich eine separate X-Positionsrolle definiert ist.

Zugriffsfunktionen:

Benachrichtigungssignal:

columnRolePattern : QRegularExpression

Diese Eigenschaft legt fest, ob der von der Spaltenrolle zugeordnete Wert vor seiner Verwendung als Spaltenkategorie einer Such- und Ersetzungsfunktion unterzogen wird.

Diese Eigenschaft gibt den regulären Ausdruck an, mit dem der zu ersetzende Teil des zugeordneten Werts gesucht wird, und die Eigenschaft „ columnRoleReplace “ enthält die Ersatzzeichenfolge.

Zugriffsfunktionen:

Benachrichtigungssignal:

Siehe auch „ columnRole “ und „ columnRoleReplace “.

columnRoleReplace : QString

Diese Eigenschaft enthält den Ersetzungsinhalt, der in Verbindung mit einem Spaltenrollenmuster verwendet werden soll.

Standardmäßig ist dies eine leere Zeichenfolge. 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).

Zugriffsfunktionen:

Benachrichtigungssignal:

Siehe auch „ columnRole “ und „ columnRolePattern “.

itemModel : QAbstractItemModel*

Diese Eigenschaft enthält das Elementmodell, das als Datenquelle für die 3D-Oberfläche verwendet wird.

Zugriffsfunktionen:

Benachrichtigungssignal:

multiMatchBehavior : QItemModelSurfaceDataProxy::MultiMatchBehavior

Wie mit mehreren Übereinstimmungen für jede Zeilen-/Spaltenkombination umgegangen wird.

Standardmäßig ist „Last“ eingestellt.

Beispiel: Sie haben ein Elementmodell mit zeitgestempelten Daten, die in unregelmäßigen Abständen erfasst wurden, und möchten die durchschnittliche Position der Datenelemente pro Stunde mit einem Oberflächendiagramm visualisieren. Dies erreichen Sie, indem Sie Zeilen- und Spaltenkategorien so festlegen, dass jeder Punkt auf der Oberfläche eine Stunde darstellt, und diese Eigenschaft auf „Durchschnitt“ setzen.

Zugriffsfunktionen:

Benachrichtigungssignal:

rowCategories : QStringList

Diese Eigenschaft enthält die Zeilenkategorien für die Zuordnung.

Zugriffsfunktionen:

Benachrichtigungssignal:

rowRole : QString

Diese Eigenschaft enthält die Rolle des Elementmodells, die der Zeilenkategorie zugeordnet werden soll.

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 separate Z-Positionsrolle definiert ist.

Zugriffsfunktionen:

Benachrichtigungssignal:

rowRolePattern : QRegularExpression

Diese Eigenschaft gibt an, ob der von der Zeilenrolle zugeordnete Wert vor seiner Verwendung als Zeilenkategorie einer Such- und Ersetzungsfunktion unterzogen wird.

Diese Eigenschaft gibt den regulären Ausdruck an, mit dem der zu ersetzende Teil des zugeordneten Werts gesucht wird, und die Eigenschaft „ rowRoleReplace “ enthält die Ersatzzeichenfolge.

Zugriffsfunktionen:

Benachrichtigungssignal:

Siehe auch „ rowRole “ und „ rowRoleReplace “.

rowRoleReplace : QString

Diese Eigenschaft enthält den Ersatzinhalt, der in Verbindung mit dem Zeilenrollenmuster verwendet werden soll.

Der Standardwert ist eine leere Zeichenkette. Weitere Informationen zur Funktionsweise des Such- und Ersetzungsvorgangs mit regulären Ausdrücken finden Sie in der Funktionsdokumentation zu „ QString::replace “ (const QRegularExpression &rx, const QString &after).

Zugriffsfunktionen:

Notifier-Signal:

Siehe auch rowRole und rowRolePattern.

useModelCategories : bool

Diese Eigenschaft gilt unabhängig davon, ob Zeilen- und Spaltenrollen sowie Kategorien für die Zuordnung verwendet werden.

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

Zugriffsfunktionen:

Benachrichtigungssignal:

xPosRole : QString

Diese Eigenschaft enthält die Rolle des Elementmodells, die der X-Position zugeordnet werden soll.

Ist diese Rolle nicht definiert, wird „ columnRole “ verwendet, um den X-Koordinatenwert der aufgelösten „ QSurfaceDataItem “-Objekte zu ermitteln.

Zugriffsfunktionen:

Benachrichtigungssignal:

xPosRolePattern : QRegularExpression

Diese Eigenschaft legt fest, ob der durch die Rolle „x-Position“ zugeordnete Wert vor seiner Verwendung als Elementpositionswert gesucht und ersetzt 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.

Zugriffsfunktionen:

Benachrichtigungssignal:

Siehe auch „ xPosRole “ und „ xPosRoleReplace “.

xPosRoleReplace : QString

Diese Eigenschaft enthält den Ersatzinhalt, der in Verbindung mit einem Muster für die x-Position verwendet werden soll.

Standardmäßig ist dies eine leere Zeichenfolge. 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).

Zugriffsfunktionen:

Benachrichtigungssignal:

Siehe auch „ xPosRole “ und „ xPosRolePattern “.

yPosRole : QString

Diese Eigenschaft enthält die Rolle des Elementmodells, die der Y-Position zugeordnet wird.

Zugriffsfunktionen:

Benachrichtigungssignal:

yPosRolePattern : QRegularExpression

Diese Eigenschaft legt fest, ob der durch die Rolle „y-Position“ zugeordnete Wert vor seiner Verwendung als Elementpositionswert gesucht und ersetzt 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 Ersatzzeichenfolge.

Zugriffsfunktionen:

Benachrichtigungssignal:

Siehe auch „ yPosRole “ und „ yPosRoleReplace “.

yPosRoleReplace : QString

Diese Eigenschaft enthält den Ersatzinhalt, der in Verbindung mit einem Positionsmuster vom Typ „y“ verwendet werden soll.

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

Zugriffsfunktionen:

Benachrichtigungssignal:

Siehe auch „ yPosRole “ und „ yPosRolePattern “.

zPosRole : QString

Diese Eigenschaft enthält die Rolle des Elementmodells, die der Z-Position zugeordnet werden soll.

Ist diese Rolle nicht definiert, wird „ rowRole “ verwendet, um den Z-Koordinatenwert aufgelöster „ QSurfaceDataItem “-Objekte zu ermitteln.

Zugriffsfunktionen:

Benachrichtigungssignal:

zPosRolePattern : QRegularExpression

Diese Eigenschaft legt fest, ob der durch die Rolle „z-Position“ zugeordnete Wert vor seiner Verwendung als Elementpositionswert gesucht und ersetzt wird.

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.

Zugriffsfunktionen:

Benachrichtigungssignal:

Siehe auch „ zPosRole “ und „ zPosRoleReplace “.

zPosRoleReplace : QString

Diese Eigenschaft enthält den Ersatzinhalt, der in Verbindung mit einem „z-position“-Rollenmuster verwendet werden soll.

Standardmäßig ist dies eine leere Zeichenfolge. 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).

Zugriffsfunktionen:

Benachrichtigungssignal:

Siehe auch „ zPosRole “ und „ zPosRolePattern “.