ItemModelBarDataProxy QML Type

Classe proxy permettant de présenter des données dans des modèles d'éléments avec Bars3D. En savoir plus...

Ce type est obsolète. Nous déconseillons fortement de l'utiliser dans du code nouveau.

• Liste de tous les membres, y compris les membres hérités

Propriétés

• 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

Description détaillée

Ce type vous permet d'utiliser des modèles dérivés de AbstractItemModel comme source de données pour Bars3D.

Les données sont résolues de manière asynchrone dès que le mappage ou le modèle change. L'événement QBarDataProxy::arrayReset() est déclenché lorsque les données ont été résolues.

Pour les énumérations ItemModelBarDataProxy, consultez QItemModelBarDataProxy::MultiMatchBehavior.

Pour plus de détails, consultez la documentation de QItemModelBarDataProxy.

Exemple d'utilisation :

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"]
}

Voir également BarDataProxy et Gestion des données dansQt Data Visualization .

Documentation sur les propriétés

autoColumnCategories : bool

Lorsqu’il est défini sur « true », le mappage ignore toutes 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 ».

autoRowCategories : bool

Lorsqu'il est défini sur « true », le mappage ignore toutes les catégories de lignes 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 ».

columnCategories : list<String>

Les catégories de colonnes du mappage. Seuls les éléments dont les valeurs de rôle de colonne figurent dans cette liste sont pris en compte lors de la résolution des données. Les colonnes sont classées dans le même ordre que celui de cette liste.

columnRole : string

Le rôle du modèle d'élément à associer à la catégorie de colonne.

columnRolePattern : regExp

Lorsqu'elle est définie, 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 rechercher 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.

Voir également columnRole et columnRoleReplace.

columnRoleReplace : string

Cette propriété définit le contenu de remplacement à utiliser conjointement 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).

Voir également columnRole et columnRolePattern.

itemModel : model

Le modèle de l'article.

multiMatchBehavior : ItemModelBarDataProxy.MultiMatchBehavior

Définit la manière dont sont gérées les correspondances multiples pour chaque combinaison ligne/colonne. La valeur par défaut est « ItemModelBarDataProxy.MMBLast ». 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 à des 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 manière à ce que chaque barre représente un jour, puis de définir multiMatchBehavior sur « ItemModelBarDataProxy.MMBCumulative ».

rotationRole : string

Le rôle du modèle d'élément à associer à l'angle de rotation de la barre.

rotationRolePattern : regExp

Lorsqu’elle est activée, 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.

Voir également rotationRole et rotationRoleReplace.

rotationRoleReplace : string

Cette propriété définit 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).

Voir également rotationRole et rotationRolePattern.

rowCategories : list<String>

Les catégories de lignes du mappage. Seuls les éléments dont les valeurs de rôle de ligne figurent dans cette liste sont pris en compte lors de la résolution des données. Les lignes sont classées dans le même ordre que celui de cette liste.

rowRole : string

Le rôle du modèle d'élément à associer à la catégorie de ligne.

rowRolePattern : regExp

Lorsqu’elle est définie, 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.

Voir également rowRole et rowRoleReplace.

rowRoleReplace : string

Cette propriété définit 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`) .

Voir également rowRole et rowRolePattern.

useModelCategories : bool

Lorsqu'il est défini sur « 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. Les en-têtes de lignes et de colonnes sont utilisés comme libellés de lignes et de colonnes. La valeur par défaut est « false ».

valueRole : string

Le rôle du modèle d'élément à associer à la valeur de la barre.

valueRolePattern : regExp

Lorsqu’elle est activée, une opération de recherche et de remplacement est effectuée sur la valeur mappée par le rôle « value » avant que celle-ci ne soit utilisée comme valeur de 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é « valueRoleReplace » contient la chaîne de remplacement.

Voir également « valueRole » et « valueRoleReplace ».

valueRoleReplace : string

Cette propriété définit 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).

Voir également valueRole et valueRolePattern.