ItemModelBarDataProxy QML Type

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

• Liste de tous les membres, y compris les membres hérités
• ItemModelBarDataProxy fait partie des types QML d'Qt Graphs pour la 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 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, voir QItemModelBarDataProxy::MultiMatchBehavior.

Pour plus de détails, consultez la documentation relative à 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 Gestion des données en 3D.

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 dans cette liste.

columnRole : string

Le rôle du modèle d'article à 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 « column role » 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.

Voir également columnRole et columnRoleReplace.

columnRoleReplace : string

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

Voir également columnRole et columnRolePattern.

itemModel : model

Le modèle de l'article.

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 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 manière à ce que chaque barre représente un jour, puis de définir multiMatchBehavior sur « ItemModelBarDataProxy.MultiMatchBehavior.Cumulative ».

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 que celle-ci 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 dans 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 rechercher 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 relative à la fonction ` QString::replace` (const QRegularExpression &rx, const QString &after).

Voir également rowRole et rowRolePattern.

type : AbstractDataProxy.DataType [read-only]

Le type du proxy. L'une des valeurs suivantes : QAbstractDataProxy::DataType.

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 étiquettes 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 définie, 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 relative à 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 change.

columnRoleChanged(string role)

Ce signal est émis lorsque columnRole devient role.

columnRolePatternChanged(regExp pattern)

Ce signal est émis lorsque l'adresse 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 change.

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.