ItemModelBarDataProxy QML Type

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

Dieser Typ ist veraltet. Wir raten dringend davon ab, ihn in neuem Code zu verwenden.

• 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

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 die Zuordnung 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: ["2010", "2011", "2012", "2013"]
    columnCategories: ["Oulu", "Rauma", "Helsinki", "Tampere"]
}

Siehe auch „ BarDataProxy “ und „Qt Data Visualization -Datenverarbeitung“.

Eigenschaftsdokumentation

autoColumnCategories : bool

Bei der Einstellung „ true “ ignoriert die Zuordnung alle explizit festgelegten Spaltenkategorien und überschreibt diese durch automatisch generierte, 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 einer Such- und Ersetzungsoperation unterzogen, bevor er als Spaltenkategorie verwendet wird. 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 einzigen Zeitstempelfeld im Elementmodell zu parsen.

Siehe auch „ columnRole “ und „ columnRoleReplace “.

columnRoleReplace : string

Diese Eigenschaft definiert den Ersetzungsinhalt, 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 : ItemModelBarDataProxy.MultiMatchBehavior

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

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

rotationRole : string

Die Rolle des Artikelmodells, die dem Drehwinkel des Balkens 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 Ersetzungsinhalt, der in Verbindung mit ` rotationRolePattern` 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 rotationRole und rotationRolePattern.

rowCategories : list<String>

Die Zeilenkategorien der Zuordnung. Bei der Datenauflösung 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 Ersetzungsinhalt, der in Verbindung mit „ rowRolePattern “ verwendet werden soll. Der Standardwert ist eine leere Zeichenfolge. Weitere Informationen zur Funktionsweise der Suche und des Ersetzens mithilfe regulärer Ausdrücke finden Sie in der Funktionsdokumentation zu „ 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 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 Ersetzungsinhalt, 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.