ItemModelBarDataProxy QML Type

Classe proxy pour la présentation des données dans les modèles d'éléments avec Bars3D. Plus d'informations...

• Liste de tous les membres, y compris les membres hérités
• ItemModelBarDataProxy fait partie de Qt Graphs QML Types for 3D.

Propriétés

• autoColumnCategories : bool
• autoRowCategories : bool
• columnCategories : list<String>
• columnRole : string
• columnRolePattern : regExp
• columnRoleReplace : string
• itemModel : model
• multiMatchBehavior : enumeration
• rotationRole : string
• rotationRolePattern : regExp
• rotationRoleReplace : string
• rowCategories : list<String>
• rowRole : string
• rowRolePattern : regExp
• rowRoleReplace : string
• type : AbstractDataProxy.DataType
• useModelCategories : bool
• valueRole : string
• valueRolePattern : regExp
• valueRoleReplace : string

Signaux

• autoColumnCategoriesChanged(bool enable)
• autoRowCategoriesChanged(bool enable)
• columnCategoriesChanged()
• columnRoleChanged(string role)
• columnRolePatternChanged(regExp pattern)
• columnRoleReplaceChanged(string replace)
• itemModelChanged(model itemModel)
• multiMatchBehaviorChanged(enumeration behavior)
• rotationRoleChanged(string role)
• rotationRolePatternChanged(regExp pattern)
• rotationRoleReplaceChanged(string replace)
• rowCategoriesChanged()
• rowRoleChanged(string role)
• rowRolePatternChanged(regExp pattern)
• rowRoleReplaceChanged(string replace)
• useModelCategoriesChanged(bool enable)
• valueRoleChanged(string role)
• valueRolePatternChanged(regExp pattern)
• valueRoleReplaceChanged(string replace)

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 chaque fois que le mappage ou le modèle change. QBarDataProxy::arrayReset() est émis lorsque les données ont été résolues.

Pour les enums ItemModelBarDataProxy, voir QItemModelBarDataProxy::MultiMatchBehavior.

Pour plus de détails, voir la documentation 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: ["2020", "2021", "2022", "2023"]
    columnCategories: ["Oulu", "Rauma", "Helsinki", "Tampere"]
}

Voir également BarDataProxy et Qt Graphs Data Handling with 3D.

Documentation sur les propriétés

autoColumnCategories : bool

Lorsqu'il est défini sur 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.

autoRowCategories : bool

Lorsqu'il a pour valeur true, le mappage ignore les catégories de ligne explicitement définies 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 inclus lors de la résolution des données. Les colonnes sont classées dans le même ordre que dans cette liste.

columnRole : string

Le rôle du modèle d'élément à mettre en correspondance avec la catégorie de colonne.

columnRolePattern : regExp

Lorsque cette propriété est activée, une recherche et un remplacement sont effectués sur la valeur mappée par le rôle de la 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.

Voir également columnRole et columnRoleReplace.

columnRoleReplace : string

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

Voir également columnRole et columnRolePattern.

itemModel : model

Le modèle de l'élément.

multiMatchBehavior : enumeration

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.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 souhaitez visualiser la valeur totale des éléments de données chaque jour à l'aide d'un graphique à barres. Pour ce faire, spécifiez les catégories de lignes et de colonnes de sorte que chaque barre représente un jour et attribuez la valeur ItemModelBarDataProxy.MultiMatchBehavior.Cumulative à multiMatchBehavior.

rotationRole : string

Le rôle du modèle de l'élément à mettre en correspondance avec l'angle de rotation de la barre.

rotationRolePattern : regExp

Lorsque cette propriété est activée, 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.

Voir également rotationRole et rotationRoleReplace.

rotationRoleReplace : string

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

Voir également rotationRole et rotationRolePattern.

rowCategories : list<String>

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

rowRole : string

Le rôle du modèle d'élément à mettre en correspondance avec la catégorie de ligne.

rowRolePattern : regExp

Lorsque cette propriété est activée, 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.

Voir également rowRole et rowRoleReplace.

rowRoleReplace : string

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

Voir également rowRole et rowRolePattern.

type : AbstractDataProxy.DataType [read-only]

Le type de proxy. Une des valeurs QAbstractDataProxy::DataType.

useModelCategories : bool

Lorsque la valeur est 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 ligne et de colonne sont utilisés pour les étiquettes de ligne et de colonne. La valeur par défaut est false.

valueRole : string

Le rôle du modèle d'élément à mettre en correspondance avec la valeur de la barre.

valueRolePattern : regExp

Lorsque cette propriété est activée, 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.

Voir également valueRole et valueRoleReplace.

valueRoleReplace : string

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

Voir également valueRole et valueRolePattern.

Documentation sur les signaux

autoColumnCategoriesChanged(bool enable)

Ce signal est émis lorsque autoColumnCategories devient enable.

autoRowCategoriesChanged(bool enable)

Ce signal est émis lorsque autoRowCategories devient enable.

columnCategoriesChanged()

Ce signal est émis lorsque columnCategories est modifié.

columnRoleChanged(string role)

Ce signal est émis lorsque columnRole devient role.

columnRolePatternChanged(regExp pattern)

Ce signal est émis lorsque columnRolePattern devient pattern.

columnRoleReplaceChanged(string replace)

Ce signal est émis lorsque columnRoleReplace devient replace.

itemModelChanged(model itemModel)

Ce signal est émis lorsque itemModel devient itemModel.

multiMatchBehaviorChanged(enumeration behavior)

Ce signal est émis lorsque multiMatchBehavior devient behavior.

rotationRoleChanged(string role)

Ce signal est émis lorsque rotationRole devient role.

rotationRolePatternChanged(regExp pattern)

Ce signal est émis lorsque rotationRolePattern devient pattern.

rotationRoleReplaceChanged(string replace)

Ce signal est émis lorsque rotationRoleReplace devient replace.

rowCategoriesChanged()

Ce signal est émis lorsque rowCategories est modifié.

rowRoleChanged(string role)

Ce signal est émis lorsque rowRole devient role.

rowRolePatternChanged(regExp pattern)

Ce signal est émis lorsque rowRolePattern devient pattern.

rowRoleReplaceChanged(string replace)

Ce signal est émis lorsque rowRoleReplace devient replace.

useModelCategoriesChanged(bool enable)

Ce signal est émis lorsque useModelCategories devient enable.

valueRoleChanged(string role)

Ce signal est émis lorsque valueRole devient role.

valueRolePatternChanged(regExp pattern)

Ce signal est émis lorsque valueRolePattern devient pattern.

valueRoleReplaceChanged(string replace)

Ce signal est émis lorsque valueRoleReplace devient replace.