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é détermine si les catégories de colonnes sont générées automatiquement.

Lorsqu’elle est définie sur « true », la mise en correspondance ignore toutes les catégories de colonnes 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 :

autoRowCategories : bool

Cette propriété s'applique que les catégories de lignes soient générées automatiquement ou non.

Lorsqu’elle est définie sur « true », la mise en correspondance ignore toutes les catégories de lignes 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 des colonnes pour le mappage.

Fonctions d'accès :

Signal de notification :

columnRole : QString

Cette propriété définit le rôle de la colonne dans le mappage.

Fonctions d'accès :

Signal de notification :

columnRolePattern : QRegularExpression

Cette propriété indique si une opération de recherche et de remplacement est effectuée 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 permettant de trouver la partie de la valeur mappée à remplacer, tandis que la propriété « columnRoleReplace » contient la chaîne de remplacement. Cela s'avère utile, par exemple, pour analyser les catégories de lignes et de colonnes à partir d'un seul champ d'horodatage 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 la méthode 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, consultez la documentation de la fonction QString::replace(const QRegularExpression &rx, const QString &after).

Fonctions d'accès :

Signal de notification :

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 des barres et leur rotation.

Par exemple, vous pouvez disposer d’un modèle d’éléments contenant des données horodatées collectées à intervalles irréguliers et souhaiter visualiser la valeur totale des éléments de données pour chaque jour à l’aide d’un graphique à barres. Pour ce faire, il suffit de spécifier des catégories de lignes et de colonnes de sorte que chaque barre représente un jour, puis de définir multiMatchBehavior sur QItemModelBarDataProxy::MultiMatchBehavior::Cumulative.

Fonctions d’accès :

Signal de notification :

rotationRole : QString

Cette propriété définit le rôle de rotation pour la mise en correspondance.

Fonctions d'accès :

Signal de notification :

rotationRolePattern : QRegularExpression

Cette propriété indique si une opération de recherche et de remplacement est effectuée 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 rechercher la partie de la valeur mappée à remplacer, tandis que la propriété « rotationRoleReplace » contient la chaîne de remplacement.

Fonctions d'accès :

Signal de notification :

Voir également « rotationRole » et « rotationRoleReplace ».

rotationRoleReplace : QString

Cette propriété contient le contenu de remplacement à utiliser avec la méthode 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, consultez la documentation de la fonction QString::replace(const QRegularExpression &rx, const QString &after).

Fonctions d’accès :

Signal de notification :

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é joue le rôle de ligne dans le mappage.

Fonctions d'accès :

Signal de notification :

rowRolePattern : QRegularExpression

Cette propriété indique si une opération de recherche et de remplacement est effectuée 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 permettant de trouver la partie de la valeur mappée à remplacer, tandis que la propriété « rowRoleReplace » contient la chaîne de remplacement. Cela s'avère utile, par exemple, pour analyser les catégories de lignes et de colonnes à partir d'un seul champ d'horodatage 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 la méthode ` 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, consultez la documentation de la fonction QString::replace(const QRegularExpression &rx, const QString &after).

Fonctions d’accès :

Signal de notification :

Voir également rowRole et rowRolePattern.

useModelCategories : bool

Cette propriété s'applique que les rôles et catégories de lignes et de colonnes soient utilisés ou non pour le mappage.

Lorsqu’elle est définie sur « true », la mise en correspondance ignore les rôles et catégories de lignes et de colonnes, et utilise à la place les lignes et colonnes du modèle. La valeur par défaut est « false ».

Fonctions d'accès :

Signal de notification :

valueRole : QString

Cette propriété définit le rôle de la correspondance.

Fonctions d'accès :

Signal de notification :

valueRolePattern : QRegularExpression

Cette propriété indique si une opération de recherche et de remplacement est effectuée 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 repérer la partie de la valeur mappée à remplacer, tandis que la propriété « valueRoleReplace » contient la chaîne de remplacement.

Fonctions d’accès :

Signal de notification :

Voir également « valueRole » et « valueRoleReplace ».

valueRoleReplace : QString

Cette propriété contient le contenu de remplacement à utiliser avec la méthode 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, consultez la documentation de la fonction QString::replace(const QRegularExpression &rx, const QString &after).

Fonctions d’accès :

Signal de notification :

Voir également valueRole et valueRolePattern.