ItemModelBarDataProxy QML Type

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

• Liste aller Mitglieder, einschließlich geerbter Mitglieder
• ItemModelBarDataProxy ist Teil von „Qt Graphs QML-Typen für 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)

Ausführliche Beschreibung

Dieser Typ ermöglicht es Ihnen, von `AbstractItemModel` abgeleitete Modelle als Datenquelle für ` Bars3D` zu verwenden.

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

Informationen zu den Enums von `ItemModelBarDataProxy` finden Sie unter ` QItemModelBarDataProxy::MultiMatchBehavior`.

Weitere Informationen finden Sie in der Dokumentation zu ` QItemModelBarDataProxy `.

Anwendungsbeispiel:

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

Eigenschaftsdokumentation

autoColumnCategories : bool

Bei der Einstellung „ true “ ignoriert die Zuordnung alle explizit festgelegten Spaltenkategorien und überschreibt diese durch automatisch generierte Kategorien, sobald die Daten aus dem Modell aufgelöst werden. Die Standardeinstellung lautet „ true “.

autoRowCategories : bool

Bei der Einstellung „ true “ ignoriert die Zuordnung alle explizit festgelegten Zeilenkategorien und überschreibt diese durch automatisch generierte Kategorien, sobald die Daten aus dem Modell aufgelöst werden. Die Standardeinstellung lautet „ true “.

columnCategories : list<String>

Die Spaltenkategorien der Zuordnung. Bei der Datenauflösung werden nur Elemente berücksichtigt, deren Spaltenrollenwerte in dieser Liste enthalten sind. Die Spalten sind in derselben Reihenfolge angeordnet wie in dieser Liste.

columnRole : string

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

columnRolePattern : regExp

Wenn diese Eigenschaft gesetzt ist, wird der durch die Spaltenrolle zugeordnete Wert vor seiner Verwendung als Spaltenkategorie einer Such- und Ersetzungsoperation unterzogen. 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 Ersetzungszeichenfolge. Dies ist beispielsweise nützlich, um Zeilen- und Spaltenkategorien aus einem einzelnen Zeitstempelfeld im Elementmodell zu parsen.

Siehe auch „ columnRole “ und „ columnRoleReplace “.

columnRoleReplace : string

Diese Eigenschaft definiert den Ersatzinhalt, der in Verbindung mit „ columnRolePattern “ verwendet werden soll. Der Standardwert ist eine leere Zeichenkette. Weitere Informationen zur Funktionsweise der Suche und des Ersetzens mit regulären Ausdrücken finden Sie in der Funktionsdokumentation zu „ QString::replace “ (const QRegularExpression &rx, const QString &after).

Siehe auch columnRole und columnRolePattern.

itemModel : model

Das Artikelmodell.

multiMatchBehavior : enumeration

Legt fest, wie mit mehreren Übereinstimmungen für jede Zeilen-/Spaltenkombination umgegangen wird. Die Standardeinstellung ist „ ItemModelBarDataProxy.MultiMatchBehavior.Last “. Das gewählte Verhalten wirkt sich sowohl auf den Balkenwert als auch auf die Drehung aus.

Beispiel: Sie haben möglicherweise ein Elementmodell mit zeitgestempelten Daten, die in unregelmäßigen Abständen erfasst wurden, und möchten den Gesamtwert der Datenelemente für jeden Tag in einem Balkendiagramm visualisieren. Dies erreichen Sie, indem Sie Zeilen- und Spaltenkategorien so festlegen, dass jeder Balken einen Tag darstellt, und „multiMatchBehavior“ auf „ ItemModelBarDataProxy.MultiMatchBehavior.Cumulative “ setzen.

rotationRole : string

Die Rolle des Artikelmodells, die dem Drehwinkel der Stange zugeordnet wird.

rotationRolePattern : regExp

Wenn diese Eigenschaft gesetzt ist, wird der durch die Rotationsrolle zugeordnete Wert vor seiner Verwendung als Balkenrotationswinkel 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 „ rotationRoleReplace “ enthält die Ersatzzeichenfolge.

Siehe auch „ rotationRole “ und „ rotationRoleReplace “.

rotationRoleReplace : string

Diese Eigenschaft definiert den Ersatzinhalt, der in Verbindung mit „ rotationRolePattern “ verwendet werden soll. Der Standardwert ist eine leere Zeichenkette. Weitere Informationen zur Funktionsweise des Suchens und Ersetzens mit regulären Ausdrücken finden Sie in der Funktionsdokumentation zu „ QString::replace “ (const QRegularExpression &rx, const QString &after).

Siehe auch rotationRole und rotationRolePattern.

rowCategories : list<String>

Die Zeilenkategorien der Zuordnung. Bei der Auflösung der Daten werden nur Elemente berücksichtigt, deren Werte für die Zeilenrolle in dieser Liste enthalten sind. Die Zeilen werden in derselben Reihenfolge sortiert wie in dieser Liste.

rowRole : string

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

rowRolePattern : regExp

Wenn diese Eigenschaft gesetzt ist, wird der durch die Zeilenrolle zugeordnete Wert einer Such- und Ersetzungsoperation unterzogen, bevor er als Zeilenkategorie verwendet wird. 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 Ersetzungszeichenfolge. Dies ist beispielsweise nützlich, um Zeilen- und Spaltenkategorien aus einem einzelnen Zeitstempelfeld im Elementmodell zu parsen.

Siehe auch „ rowRole “ und „ rowRoleReplace “.

rowRoleReplace : string

Diese Eigenschaft definiert den Ersatzinhalt, der in Verbindung mit „ rowRolePattern “ verwendet werden soll. Der Standardwert ist eine leere Zeichenkette. Weitere Informationen zur Funktionsweise der Suche und des Ersetzens mit regulären Ausdrücken finden Sie in der Funktionsdokumentation zu „ QString::replace “ (const QRegularExpression &rx, const QString &after).

Siehe auch rowRole und rowRolePattern.

type : AbstractDataProxy.DataType [read-only]

Der Typ des Proxy. Einer der Werte aus „ QAbstractDataProxy::DataType “.

useModelCategories : bool

Bei der Einstellung „ true “ ignoriert die Zuordnung Zeilen- und Spaltenrollen sowie Kategorien und verwendet stattdessen die Zeilen und Spalten aus dem Modell. Zeilen- und Spaltenüberschriften werden als Zeilen- und Spaltenbezeichnungen verwendet. Die Standardeinstellung lautet „ false “.

valueRole : string

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

valueRolePattern : regExp

Wenn diese Eigenschaft gesetzt ist, wird der durch die Rolle „value“ zugeordnete Wert vor seiner Verwendung als Balkenwert 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 „ valueRoleReplace “ enthält die Ersatzzeichenfolge.

Siehe auch „ valueRole “ und „ valueRoleReplace “.

valueRoleReplace : string

Diese Eigenschaft definiert den Ersatzinhalt, der in Verbindung mit „ valueRolePattern “ verwendet werden soll. Der Standardwert ist eine leere Zeichenkette. Weitere Informationen zur Funktionsweise der Suche und des Ersetzens mit regulären Ausdrücken finden Sie in der Funktionsdokumentation zu „ QString::replace “ (const QRegularExpression &rx, const QString &after).

Siehe auch valueRole und valueRolePattern.

Signal-Dokumentation

autoColumnCategoriesChanged(bool enable)

Dieses Signal wird ausgelöst, wenn sich „ autoColumnCategories “ in „ enable “ ändert.

autoRowCategoriesChanged(bool enable)

Dieses Signal wird ausgelöst, wenn sich autoRowCategories in enable ändert.

columnCategoriesChanged()

Dieses Signal wird ausgelöst, wenn sich columnCategories ändert.

columnRoleChanged(string role)

Dieses Signal wird ausgelöst, wenn sich „ columnRole “ in „ role “ ändert.

columnRolePatternChanged(regExp pattern)

Dieses Signal wird ausgelöst, wenn sich „ columnRolePattern “ in „ pattern “ ändert.

columnRoleReplaceChanged(string replace)

Dieses Signal wird ausgelöst, wenn sich columnRoleReplace in replace ändert.

itemModelChanged(model itemModel)

Dieses Signal wird ausgelöst, wenn sich „ itemModel “ in „ itemModel “ ändert.

multiMatchBehaviorChanged(enumeration behavior)

Dieses Signal wird ausgelöst, wenn sich „ multiMatchBehavior “ in „ behavior “ ändert.

rotationRoleChanged(string role)

Dieses Signal wird ausgelöst, wenn sich rotationRole in role ändert.

rotationRolePatternChanged(regExp pattern)

Dieses Signal wird ausgelöst, wenn sich rotationRolePattern in pattern ändert.

rotationRoleReplaceChanged(string replace)

Dieses Signal wird ausgelöst, wenn sich „ rotationRoleReplace “ in „ replace “ ändert.

rowCategoriesChanged()

Dieses Signal wird ausgelöst, wenn sich rowCategories ändert.

rowRoleChanged(string role)

Dieses Signal wird ausgelöst, wenn sich rowRole in role ändert.

rowRolePatternChanged(regExp pattern)

Dieses Signal wird ausgelöst, wenn sich „ rowRolePattern “ in „ pattern “ ändert.

rowRoleReplaceChanged(string replace)

Dieses Signal wird ausgelöst, wenn sich rowRoleReplace in replace ändert.

useModelCategoriesChanged(bool enable)

Dieses Signal wird ausgelöst, wenn sich useModelCategories in enable ändert.

valueRoleChanged(string role)

Dieses Signal wird ausgelöst, wenn sich „ valueRole “ in „ role “ ändert.

valueRolePatternChanged(regExp pattern)

Dieses Signal wird ausgelöst, wenn sich „ valueRolePattern “ in „ pattern “ ändert.

valueRoleReplaceChanged(string replace)

Dieses Signal wird ausgelöst, wenn sich valueRoleReplace in replace ändert.