ItemModelBarDataProxy QML Type

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

• Liste aller Mitglieder, einschließlich geerbter Mitglieder

Eigenschaften

• autoColumnCategories : bool
• autoRowCategories : bool
• columnCategories : list<String>
• columnRole : string
• columnRolePattern : regExp
• columnRoleReplace : string
• itemModel : model
• multiMatchBehavior : ItemModelBarDataProxy.MultiMatchBehavior
• rotationRole : string
• rotationRolePattern : regExp
• rotationRoleReplace : string
• rowCategories : list<String>
• rowRole : string
• rowRolePattern : regExp
• rowRoleReplace : string
• useModelCategories : bool
• valueRole : string
• valueRolePattern : regExp
• valueRoleReplace : string

Detaillierte Beschreibung

Mit diesem Typ können Sie von AbstractItemModel abgeleitete Modelle als Datenquelle für Bars3D verwenden.

Die Daten werden asynchron aufgelöst, wenn sich das Mapping oder das Modell ändert. QBarDataProxy::arrayReset() wird ausgegeben, wenn die Daten aufgelöst wurden.

Für ItemModelBarDataProxy enums, siehe QItemModelBarDataProxy::MultiMatchBehavior.

Weitere Details finden Sie in der Dokumentation QItemModelBarDataProxy.

Beispiel für die Verwendung:

ItemModelBarDataProxy {
    itemModel: model // E.g. a list model defined elsewhere containing yearly expenses data.
    // Mapping model roles to bar series rows, columns, and values.
    rowRole: "year"
    columnRole: "city"
    valueRole: "expenses"
    rowCategories: ["2010", "2011", "2012", "2013"]
    columnCategories: ["Oulu", "Rauma", "Helsinki", "Tampere"]
}

Siehe auch BarDataProxy und Qt Data Visualization Data Handling.

Dokumentation der Eigenschaft

autoColumnCategories : bool

Bei der Einstellung true ignoriert das Mapping alle explizit gesetzten Spaltenkategorien und überschreibt sie mit automatisch generierten, wenn die Daten aus dem Modell aufgelöst werden. Die Standardeinstellung ist true.

autoRowCategories : bool

Bei der Einstellung true ignoriert die Zuordnung alle explizit gesetzten Zeilenkategorien und überschreibt sie mit automatisch generierten Kategorien, wenn die Daten aus dem Modell aufgelöst werden. Die Standardeinstellung ist true.

columnCategories : list<String>

Die Spaltenkategorien des Mappings. Nur Elemente mit Spaltenrollenwerten, die in dieser Liste zu finden sind, werden bei der Auflösung der Daten berücksichtigt. Die Spalten werden in der gleichen Reihenfolge wie in dieser Liste angeordnet.

columnRole : string

Die Rolle des Positionsmodells, die der Spaltenkategorie zugeordnet werden soll.

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. Dies ist zum Beispiel beim Parsen von Zeilen- und Spaltenkategorien aus einem einzelnen Zeitstempelfeld im Artikelmodell nützlich.

Siehe auch columnRole und columnRoleReplace.

columnRoleReplace : string

Diese Eigenschaft definiert den zu ersetzenden Inhalt, 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.

multiMatchBehavior : ItemModelBarDataProxy.MultiMatchBehavior

Legt fest, wie mehrere Übereinstimmungen für jede Zeilen-/Spaltenkombination behandelt werden. Die Standardeinstellung ist ItemModelBarDataProxy.MMBLast. Das gewählte Verhalten wirkt sich sowohl auf den Balkenwert als auch auf die Drehung aus.

Sie haben zum Beispiel ein Elementmodell mit zeitgestempelten Daten, die in unregelmäßigen Abständen erfasst werden, und möchten den Gesamtwert der Datenelemente an jedem Tag mit einem Balkendiagramm darstellen. Dazu geben Sie Zeilen- und Spaltenkategorien an, so dass jeder Balken einen Tag darstellt, und setzen multiMatchBehavior auf ItemModelBarDataProxy.MMBCumulative.

rotationRole : string

Die Rolle des Item-Modells wird auf den Drehwinkel der Stange abgebildet.

rotationRolePattern : regExp

Wenn diese Eigenschaft gesetzt ist, wird der durch die Rotationsrolle zugeordnete Wert gesucht und ersetzt, bevor er als Balkenrotationswinkel verwendet wird. Diese Eigenschaft gibt den regulären Ausdruck an, um den zu ersetzenden Teil des zugeordneten Wertes zu finden, und die Eigenschaft rotationRoleReplace enthält die Ersetzungszeichenfolge.

Siehe auch rotationRole und rotationRoleReplace.

rotationRoleReplace : string

Diese Eigenschaft definiert den zu ersetzenden Inhalt, der in Verbindung mit rotationRolePattern 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 rotationRole und rotationRolePattern.

rowCategories : list<String>

Die Zeilenkategorien des Mappings. Nur Elemente mit Zeilenrollenwerten, die in dieser Liste zu finden sind, werden bei der Auflösung der Daten berücksichtigt. Die Zeilen werden in der gleichen Reihenfolge wie in dieser Liste angeordnet.

rowRole : string

Die Rolle des Positionsmodells, die der Zeilenkategorie zugeordnet werden soll.

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 Ersatzzeichenfolge. Dies ist z. B. beim Parsen von Zeilen- und Spaltenkategorien aus einem einzelnen Zeitstempelfeld im Artikelmodell nützlich.

Siehe auch rowRole und rowRoleReplace.

rowRoleReplace : string

Diese Eigenschaft definiert den zu ersetzenden Inhalt, 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.

useModelCategories : bool

Bei der Einstellung true ignoriert die Zuordnung die Zeilen- und Spaltenrollen und -kategorien und verwendet stattdessen die Zeilen und Spalten aus dem Modell. Zeilen- und Spaltenüberschriften werden für Zeilen- und Spaltenbeschriftungen verwendet. Die Standardeinstellung ist false.

valueRole : string

Die Rolle des Artikelmodells, die dem Balkenwert zugeordnet werden soll.

valueRolePattern : regExp

Wenn diese Eigenschaft gesetzt ist, wird der durch die Wertrolle zugeordnete Wert gesucht und ersetzt, bevor er als Balkenwert verwendet wird. Diese Eigenschaft gibt den regulären Ausdruck an, um den zu ersetzenden Teil des zugeordneten Wertes zu finden, und die Eigenschaft valueRoleReplace enthält die Ersetzungszeichenfolge.

Siehe auch valueRole und valueRoleReplace.

valueRoleReplace : string

Diese Eigenschaft definiert den zu ersetzenden Inhalt, der in Verbindung mit valueRolePattern 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 valueRole und valueRolePattern.