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"));

Eigenschaftsdokumentation

autoColumnCategories : bool

Diese Eigenschaft legt fest, ob Spaltenkategorien automatisch generiert werden.

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 ist „ true “.

Zugriffsfunktionen:

Benachrichtigungssignal:

autoRowCategories : bool

Diese Eigenschaft legt fest, ob Zeilenkategorien automatisch generiert werden.

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

Zugriffsfunktionen:

Benachrichtigungssignal:

columnCategories : QStringList

Diese Eigenschaft enthält die Spaltenkategorien für die Zuordnung.

Zugriffsfunktionen:

Benachrichtigungssignal:

columnRole : QString

Diese Eigenschaft legt die Spaltenrolle für die Zuordnung fest.

Zugriffsfunktionen:

Benachrichtigungssignal:

columnRolePattern : QRegularExpression

Diese Eigenschaft legt fest, ob der durch die Spaltenrolle zugeordnete Wert vor seiner Verwendung als Spaltenkategorie gesucht und ersetzt wird.

Diese Eigenschaft gibt den regulären Ausdruck an, mit dem der zu ersetzende Teil des zugeordneten Werts gesucht wird, und die Eigenschaft „ columnRoleReplace “ enthält die Ersatzzeichenfolge. Dies ist beispielsweise nützlich, um Zeilen- und Spaltenkategorien aus einem einzelnen Zeitstempelfeld im Elementmodell zu parsen.

Zugriffsfunktionen:

Benachrichtigungssignal:

Siehe auch „ columnRole “ und „ columnRoleReplace “.

columnRoleReplace : QString

Diese Eigenschaft enthält den Ersatzinhalt, der in Verbindung mit „ columnRolePattern “ verwendet werden soll.

Standardmäßig ist dies eine leere Zeichenfolge. 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).

Zugriffsfunktionen:

Notifier-Signal:

Siehe auch columnRole und columnRolePattern.

itemModel : QAbstractItemModel*

Diese Eigenschaft enthält das Elementmodell.

Zugriffsfunktionen:

Notifier-Signal:

multiMatchBehavior : QItemModelBarDataProxy::MultiMatchBehavior

Wie mit mehreren Übereinstimmungen für jede Zeilen-/Spaltenkombination umgegangen wird.

Standardmäßig ist „ QItemModelBarDataProxy::MultiMatchBehavior::Last “ eingestellt. 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 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 „ QItemModelBarDataProxy::MultiMatchBehavior::Cumulative “ setzen.

Zugriffsfunktionen:

Notifier-Signal:

rotationRole : QString

Diese Eigenschaft bestimmt die Rotation für die Zuordnung.

Zugriffsfunktionen:

Benachrichtigungssignal:

rotationRolePattern : QRegularExpression

Diese Eigenschaft legt fest, ob der durch die Rotationsrolle zugeordnete Wert vor seiner Verwendung als Balkenrotationswinkel gesucht und ersetzt wird.

Diese Eigenschaft gibt den regulären Ausdruck an, mit dem der zu ersetzende Teil des zugeordneten Werts ermittelt wird, und die Eigenschaft „ rotationRoleReplace “ enthält die Ersatzzeichenfolge.

Zugriffsfunktionen:

Benachrichtigungssignal:

Siehe auch „ rotationRole “ und „ rotationRoleReplace “.

rotationRoleReplace : QString

Diese Eigenschaft enthält den Ersatzinhalt, der in Verbindung mit „ rotationRolePattern “ verwendet werden soll.

Standardmäßig ist dies 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).

Zugriffsfunktionen:

Notifier-Signal:

Siehe auch rotationRole und rotationRolePattern.

rowCategories : QStringList

Diese Eigenschaft enthält die Zeilenkategorien für die Zuordnung.

Zugriffsfunktionen:

Benachrichtigungssignal:

rowRole : QString

Diese Eigenschaft übernimmt die Zeilenrolle für die Zuordnung.

Zugriffsfunktionen:

Benachrichtigungssignal:

rowRolePattern : QRegularExpression

Diese Eigenschaft gibt an, ob der durch die Zeilenrolle zugeordnete Wert vor seiner Verwendung als Zeilenkategorie gesucht und ersetzt wird.

Diese Eigenschaft gibt den regulären Ausdruck an, mit dem der zu ersetzende Teil des zugeordneten Werts gefunden wird, und die Eigenschaft „ rowRoleReplace “ enthält die Ersatzzeichenfolge. Dies ist beispielsweise nützlich, um Zeilen- und Spaltenkategorien aus einem einzelnen Zeitstempelfeld im Elementmodell zu parsen.

Zugriffsfunktionen:

Benachrichtigungssignal:

Siehe auch „ rowRole “ und „ rowRoleReplace “.

rowRoleReplace : QString

Diese Eigenschaft enthält den Ersatzinhalt, der in Verbindung mit „ rowRolePattern “ verwendet werden soll.

Standardmäßig ist dies eine leere Zeichenfolge. 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).

Zugriffsfunktionen:

Notifier-Signal:

Siehe auch rowRole und rowRolePattern.

useModelCategories : bool

Diese Eigenschaft gilt unabhängig davon, ob Zeilen- und Spaltenrollen sowie Kategorien für die Zuordnung verwendet werden.

Bei der Einstellung „ true “ ignoriert das Mapping Zeilen- und Spaltenrollen sowie Kategorien und verwendet stattdessen die Zeilen und Spalten aus dem Modell. Die Standardeinstellung ist „ false “.

Zugriffsfunktionen:

Benachrichtigungssignal:

valueRole : QString

Diese Eigenschaft enthält den Wert „role“ für die Zuordnung.

Zugriffsfunktionen:

Benachrichtigungssignal:

valueRolePattern : QRegularExpression

Diese Eigenschaft gibt an, ob der durch die Rolle „value“ zugeordnete Wert vor seiner Verwendung als Balkenwert gesucht und ersetzt wird.

Diese Eigenschaft gibt den regulären Ausdruck an, mit dem der zu ersetzende Teil des zugeordneten Werts gesucht wird, und die Eigenschaft „ valueRoleReplace “ enthält die Ersatzzeichenfolge.

Zugriffsfunktionen:

Benachrichtigungssignal:

Siehe auch „ valueRole “ und „ valueRoleReplace “.

valueRoleReplace : QString

Diese Eigenschaft enthält den Ersatzinhalt, der in Verbindung mit „ valueRolePattern “ verwendet werden soll.

Standardmäßig ist der Wert eine leere Zeichenfolge. 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).

Zugriffsfunktionen:

Notifier-Signal:

Siehe auch valueRole und valueRolePattern.