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

Documentation sur les propriétés

autoColumnCategories : bool

Cette propriété indique si les catégories de colonnes sont générées automatiquement.

Si elle vaut true, le mappage ignore les catégories de colonnes définies explicitement et les remplace par des catégories générées automatiquement chaque fois que les données du modèle sont résolues. La valeur par défaut est true.

Fonctions d'accès :

Signal de notification :

autoRowCategories : bool

Cette propriété indique si les catégories de lignes sont générées automatiquement.

Lorsque cette propriété vaut true, le mappage ignore les catégories de ligne définies explicitement et les remplace par celles générées automatiquement chaque fois que les données du modèle sont résolues. La valeur par défaut est true.

Fonctions d'accès :

Signal de notification :

columnCategories : QStringList

Cette propriété contient les catégories de colonnes pour le mappage.

Fonctions d'accès :

Signal de notification :

columnRole : QString

Cette propriété contient le rôle de la colonne pour le mappage.

Fonctions d'accès :

Signal de notification :

columnRolePattern : QRegularExpression

Cette propriété indique si une recherche et un remplacement sont effectués sur la valeur mappée par le rôle de colonne avant qu'elle ne soit utilisée comme catégorie de colonne.

Cette propriété spécifie l'expression régulière pour trouver la partie de la valeur mappée à remplacer et la propriété columnRoleReplace contient la chaîne de remplacement. Cette propriété est utile, par exemple, pour analyser les catégories de ligne et de colonne à partir d'un champ d'horodatage unique dans le modèle d'élément.

Fonctions d'accès :

Signal de notification :

Voir également columnRole et columnRoleReplace.

columnRoleReplace : QString

Cette propriété contient le contenu de remplacement à utiliser avec columnRolePattern.

La valeur par défaut est une chaîne vide. Pour plus d'informations sur le fonctionnement de la recherche et du remplacement à l'aide d'expressions régulières, voir la documentation de la fonction QString::replace(const QRegularExpression &rx, const QString &after).

Fonctions d'accès :

Signal du notificateur :

Voir également columnRole et columnRolePattern.

itemModel : QAbstractItemModel*

Cette propriété contient le modèle de l'élément.

Fonctions d'accès :

Signal de notification :

multiMatchBehavior : QItemModelBarDataProxy::MultiMatchBehavior

Comment sont gérées les correspondances multiples pour chaque combinaison ligne/colonne.

La valeur par défaut est QItemModelBarDataProxy::MultiMatchBehavior::Last. Le comportement choisi affecte à la fois la valeur de la barre et la rotation.

Par exemple, vous pouvez avoir un modèle d'élément avec des données horodatées prises à intervalles irréguliers et vous voulez visualiser la valeur totale des éléments de données pour chaque jour avec un graphique à barres. Pour ce faire, spécifiez les catégories de ligne et de colonne de sorte que chaque barre représente un jour et définissez multiMatchBehavior sur QItemModelBarDataProxy::MultiMatchBehavior::Cumulative.

Fonctions d'accès :

Signal de notification :

rotationRole : QString

Cette propriété contient le rôle de rotation pour le mappage.

Fonctions d'accès :

Signal de notification :

rotationRolePattern : QRegularExpression

Cette propriété indique si une recherche et un remplacement sont effectués sur la valeur mappée par le rôle de rotation avant qu'elle ne soit utilisée comme angle de rotation de la barre.

Cette propriété spécifie l'expression régulière permettant de trouver la partie de la valeur mappée à remplacer et la propriété rotationRoleReplace contient la chaîne de remplacement.

Fonctions d'accès :

Notifier signal :

Voir aussi rotationRole et rotationRoleReplace.

rotationRoleReplace : QString

Cette propriété contient le contenu de remplacement à utiliser avec rotationRolePattern.

La valeur par défaut est une chaîne vide. Pour plus d'informations sur le fonctionnement de la recherche et du remplacement à l'aide d'expressions régulières, voir la documentation de la fonction QString::replace(const QRegularExpression &rx, const QString &after).

Fonctions d'accès :

Signal du notificateur :

Voir également rotationRole et rotationRolePattern.

rowCategories : QStringList

Cette propriété contient les catégories de lignes pour le mappage.

Fonctions d'accès :

Signal de notification :

rowRole : QString

Cette propriété contient le rôle de la ligne pour le mappage.

Fonctions d'accès :

Signal de notification :

rowRolePattern : QRegularExpression

Cette propriété indique si une recherche et un remplacement sont effectués sur la valeur mappée par le rôle de ligne avant qu'elle ne soit utilisée comme catégorie de ligne.

Cette propriété spécifie l'expression régulière pour trouver la partie de la valeur mappée à remplacer et la propriété rowRoleReplace contient la chaîne de remplacement. Cette propriété est utile, par exemple, pour analyser les catégories de ligne et de colonne à partir d'un champ d'horodatage unique dans le modèle d'élément.

Fonctions d'accès :

Signal de notification :

Voir également rowRole et rowRoleReplace.

rowRoleReplace : QString

Cette propriété contient le contenu de remplacement à utiliser avec rowRolePattern.

La valeur par défaut est une chaîne vide. Pour plus d'informations sur le fonctionnement de la recherche et du remplacement à l'aide d'expressions régulières, voir la documentation de la fonction QString::replace(const QRegularExpression &rx, const QString &after).

Fonctions d'accès :

Signal du notificateur :

Voir également rowRole et rowRolePattern.

useModelCategories : bool

Cette propriété indique si les rôles et les catégories des lignes et des colonnes sont utilisés pour le mappage.

Si elle vaut true, le mappage ignore les rôles et les catégories des lignes et des colonnes et utilise à la place les lignes et les colonnes du modèle. La valeur par défaut est false.

Fonctions d'accès :

Signal de notification :

valueRole : QString

Cette propriété contient le rôle de la valeur pour le mappage.

Fonctions d'accès :

Signal de notification :

valueRolePattern : QRegularExpression

Cette propriété indique si une recherche et un remplacement sont effectués sur la valeur mappée par le rôle value avant qu'elle ne soit utilisée comme valeur de barre.

Cette propriété spécifie l'expression régulière permettant de trouver la partie de la valeur mappée à remplacer et la propriété valueRoleReplace contient la chaîne de remplacement.

Fonctions d'accès :

Notifier signal :

Voir aussi valueRole et valueRoleReplace.

valueRoleReplace : QString

Cette propriété contient le contenu de remplacement à utiliser avec valueRolePattern.

La valeur par défaut est une chaîne vide. Pour plus d'informations sur le fonctionnement de la recherche et du remplacement à l'aide d'expressions régulières, voir la documentation de la fonction QString::replace(const QRegularExpression &rx, const QString &after).

Fonctions d'accès :

Signal du notificateur :

Voir également valueRole et valueRolePattern.