QItemModelBarDataProxy Class

// By defining row and column categories, you tell the mapping which row and column each item
// belongs to. The categories must match the data stored in the model in the roles you define
// for row and column mapping. In this example we expect "year" role to return four digit year
// and "month" to return three letter designation for the month.
//
// An example of an item in model would be:
// Requested role -> Returned data
// "year" -> "2016" // Matches the first row category, so this item is added to the first row.
// "month" -> "jan" // Matches the first column category, so this item is added as first item in the row.
// "income" -> "12.1"
// "expenses" -> "9.2"
QStringList years;
QStringList months;
years << "2016" << "2017" << "2018" << "2019" << "2020" << "2021" << "2022";
months << "jan" << "feb" << "mar" << "apr" << "may" << "jun" << "jul" << "aug" << "sep" << "oct" << "nov" << "dec";

QItemModelBarDataProxy *proxy = new QItemModelBarDataProxy(customModel,
                                                           QStringLiteral("year"), // Row role
                                                           QStringLiteral("month"), // Column role
                                                           QStringLiteral("income"), // Value role
                                                           years, // Row categories
                                                           months); // Column categories

//...

// To display different data later, you can simply change the mapping.
proxy->setValueRole(QStringLiteral("expenses"));

Dokumentation der Eigenschaft

autoColumnCategories : bool

Diese Eigenschaft legt fest, ob Spaltenkategorien automatisch generiert werden.

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

Zugriffsfunktionen:

Notifier Signal:

autoRowCategories : bool

Diese Eigenschaft legt fest, ob Zeilenkategorien automatisch generiert werden.

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

Zugriffsfunktionen:

Melder-Signal:

columnCategories : QStringList

Diese Eigenschaft enthält die Spaltenkategorien für das Mapping.

Zugriffsfunktionen:

Melder-Signal:

columnRole : QString

Diese Eigenschaft enthält die Spaltenrolle für das Mapping.

Zugriffsfunktionen:

Melder-Signal:

columnRolePattern : QRegularExpression

Diese Eigenschaft legt fest, ob der durch die Spaltenrolle zugeordnete Wert gesucht und ersetzt wird, 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.

Zugriffsfunktionen:

Benachrichtigungssignal:

Siehe auch columnRole und columnRoleReplace.

columnRoleReplace : QString

Diese Eigenschaft enthält 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).

Zugriffsfunktionen:

Benachrichtigungssignal:

Siehe auch columnRole und columnRolePattern.

itemModel : QAbstractItemModel*

Diese Eigenschaft enthält das Objektmodell.

Zugriffsfunktionen:

Benachrichtigungssignal:

multiMatchBehavior : QItemModelBarDataProxy::MultiMatchBehavior

Wie mehrere Übereinstimmungen für jede Zeilen-/Spaltenkombination behandelt werden.

Die Standardeinstellung ist QItemModelBarDataProxy::MultiMatchBehavior::Last. Das gewählte Verhalten wirkt sich sowohl auf den Balkenwert als auch auf die Drehung aus.

Sie haben beispielsweise ein Elementmodell mit zeitgestempelten Daten, die in unregelmäßigen Abständen erfasst werden, und 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 QItemModelBarDataProxy::MultiMatchBehavior::Cumulative.

Zugriffsfunktionen:

Benachrichtigungssignal:

rotationRole : QString

Diese Eigenschaft enthält die Rotationsrolle für das Mapping.

Zugriffsfunktionen:

Melder-Signal:

rotationRolePattern : QRegularExpression

Diese Eigenschaft legt fest, ob der durch die Rotationsrolle zugeordnete Wert gesucht und ersetzt werden soll, 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.

Zugriffsfunktionen:

Benachrichtigungssignal:

Siehe auch rotationRole und rotationRoleReplace.

rotationRoleReplace : QString

Diese Eigenschaft enthält 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).

Zugriffsfunktionen:

Benachrichtigungssignal:

Siehe auch rotationRole und rotationRolePattern.

rowCategories : QStringList

Diese Eigenschaft enthält die Zeilenkategorien für das Mapping.

Zugriffsfunktionen:

Melder-Signal:

rowRole : QString

Diese Eigenschaft enthält die Zeilenrolle für das Mapping.

Zugriffsfunktionen:

Melder-Signal:

rowRolePattern : QRegularExpression

Diese Eigenschaft legt fest, ob der durch die Zeilenrolle zugeordnete Wert gesucht und ersetzt werden soll, 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.

Zugriffsfunktionen:

Benachrichtigungssignal:

Siehe auch rowRole und rowRoleReplace.

rowRoleReplace : QString

Diese Eigenschaft enthält 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).

Zugriffsfunktionen:

Benachrichtigungssignal:

Siehe auch rowRole und rowRolePattern.

useModelCategories : bool

Diese Eigenschaft gibt an, ob Zeilen- und Spaltenrollen und Kategorien für die Zuordnung verwendet werden.

Wenn sie auf true gesetzt ist, ignoriert die Zuordnung Zeilen- und Spaltenrollen und Kategorien und verwendet stattdessen die Zeilen und Spalten aus dem Modell. Der Standardwert ist false.

Zugriffsfunktionen:

Melder-Signal:

valueRole : QString

Diese Eigenschaft enthält die Wertrolle für das Mapping.

Zugriffsfunktionen:

Melder-Signal:

valueRolePattern : QRegularExpression

Diese Eigenschaft legt fest, ob der durch die Wertrolle zugeordnete Wert gesucht und ersetzt wird, 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.

Zugriffsfunktionen:

Benachrichtigungssignal:

Siehe auch valueRole und valueRoleReplace.

valueRoleReplace : QString

Diese Eigenschaft enthält 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).

Zugriffsfunktionen:

Benachrichtigungssignal:

Siehe auch valueRole und valueRolePattern.