ItemModelBarDataProxy QML Type

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

• Liste aller Mitglieder, einschließlich geerbter Mitglieder
• ItemModelBarDataProxy ist Teil von Qt Graphs QML Types for 3D.

Eigenschaften

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

Signale

• autoColumnCategoriesChanged(bool enable)
• autoRowCategoriesChanged(bool enable)
• columnCategoriesChanged()
• columnRoleChanged(string role)
• columnRolePatternChanged(regExp pattern)
• columnRoleReplaceChanged(string replace)
• itemModelChanged(model itemModel)
• multiMatchBehaviorChanged(enumeration behavior)
• rotationRoleChanged(string role)
• rotationRolePatternChanged(regExp pattern)
• rotationRoleReplaceChanged(string replace)
• rowCategoriesChanged()
• rowRoleChanged(string role)
• rowRolePatternChanged(regExp pattern)
• rowRoleReplaceChanged(string replace)
• useModelCategoriesChanged(bool enable)
• valueRoleChanged(string role)
• valueRolePatternChanged(regExp pattern)
• valueRoleReplaceChanged(string replace)

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: ["2020", "2021", "2022", "2023"]
    columnCategories: ["Oulu", "Rauma", "Helsinki", "Tampere"]
}

Siehe auch BarDataProxy und Qt Graphs Datenverarbeitung mit 3D.

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 Ersatzinhalt, 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 : enumeration

Legt fest, wie mehrere Übereinstimmungen für jede Zeilen-/Spaltenkombination behandelt werden. Die Standardeinstellung ist ItemModelBarDataProxy.MultiMatchBehavior.Last. 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.MultiMatchBehavior.Cumulative.

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 Ersatzinhalt, 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 Ersatzinhalt, 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.

type : AbstractDataProxy.DataType [read-only]

Der Typ des Proxys. Einer der Werte QAbstractDataProxy::DataType.

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 Ersatzinhalt, 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.

Signal-Dokumentation

autoColumnCategoriesChanged(bool enable)

Dieses Signal wird ausgegeben, wenn autoColumnCategories zu enable wechselt.

autoRowCategoriesChanged(bool enable)

Dieses Signal wird ausgegeben, wenn autoRowCategories zu enable wechselt.

columnCategoriesChanged()

Dieses Signal wird ausgegeben, wenn sich columnCategories ändert.

columnRoleChanged(string role)

Dieses Signal wird ausgegeben, wenn columnRole zu role wechselt.

columnRolePatternChanged(regExp pattern)

Dieses Signal wird ausgegeben, wenn columnRolePattern zu pattern wechselt.

columnRoleReplaceChanged(string replace)

Dieses Signal wird ausgegeben, wenn columnRoleReplace zu replace wechselt.

itemModelChanged(model itemModel)

Dieses Signal wird ausgegeben, wenn itemModel zu itemModel wechselt.

multiMatchBehaviorChanged(enumeration behavior)

Dieses Signal wird ausgegeben, wenn multiMatchBehavior zu behavior wechselt.

rotationRoleChanged(string role)

Dieses Signal wird ausgegeben, wenn rotationRole zu role wechselt.

rotationRolePatternChanged(regExp pattern)

Dieses Signal wird ausgegeben, wenn rotationRolePattern zu pattern wechselt.

rotationRoleReplaceChanged(string replace)

Dieses Signal wird ausgegeben, wenn rotationRoleReplace zu replace wechselt.

rowCategoriesChanged()

Dieses Signal wird ausgegeben, wenn sich rowCategories ändert.

rowRoleChanged(string role)

Dieses Signal wird ausgegeben, wenn rowRole zu role wechselt.

rowRolePatternChanged(regExp pattern)

Dieses Signal wird ausgegeben, wenn rowRolePattern zu pattern wechselt.

rowRoleReplaceChanged(string replace)

Dieses Signal wird ausgegeben, wenn rowRoleReplace zu replace wechselt.

useModelCategoriesChanged(bool enable)

Dieses Signal wird ausgegeben, wenn useModelCategories zu enable wechselt.

valueRoleChanged(string role)

Dieses Signal wird ausgegeben, wenn valueRole zu role wechselt.

valueRolePatternChanged(regExp pattern)

Dieses Signal wird ausgegeben, wenn valueRolePattern zu pattern wechselt.

valueRoleReplaceChanged(string replace)

Dieses Signal wird ausgegeben, wenn valueRoleReplace zu replace wechselt.