Back to Qt.io
Contact Us Blog Download Qt

ItemModelBarDataProxy QML Type

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

Import Statement: import QtDataVisualization 1.8
Since: QtDataVisualization 1.0
In C++: QItemModelBarDataProxy
Inherits:

BarDataProxy

Eigenschaften

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

Wenn auf true gesetzt, ignoriert das Mapping alle explizit gesetzten Spaltenkategorien und überschreibt sie mit automatisch generierten, wenn die Daten vom Modell aufgelöst werden. Die Standardeinstellung ist true.


autoRowCategories : bool

Wenn auf true gesetzt, ignoriert die Zuordnung alle explizit gesetzten Zeilenkategorien und überschreibt sie mit automatisch generierten, wenn die Daten aus dem Modell aufgelöst werden. Der Standardwert 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 Elementmodellrolle, die der Spaltenkategorie zugeordnet werden soll.


columnRolePattern : regExp

Wenn diese Eigenschaft gesetzt ist, 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 Zeichenfolge. 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 Elementmodell.


multiMatchBehavior : ItemModelBarDataProxy.MultiMatchBehavior

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

Sie könnten beispielsweise ein Elementmodell mit zeitgestempelten Daten haben, die in unregelmäßigen Abständen erfasst werden, und Sie möchten den Gesamtwert der Datenelemente an jedem Tag in 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 Elementmodells wird dem Drehwinkel des Balkens zugeordnet.


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. Standardmäßig wird eine leere Zeichenfolge verwendet. 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 Elementmodellrolle, die der Zeilenkategorie zugeordnet werden soll.


rowRolePattern : regExp

Wenn diese Eigenschaft gesetzt ist, wird der Wert, der durch die Zeilenrolle zugeordnet ist, 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. 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 Zeichenfolge. 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 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. Der Standardwert ist false.


valueRole : string

Die Elementmodellrolle, 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. Standardmäßig wird eine leere Zeichenfolge verwendet. 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.


© 2025 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.