ItemModelSurfaceDataProxy QML Type

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

• 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 : ItemModelSurfaceDataProxy.MultiMatchBehavior
• rowCategories : list<String>
• rowRole : string
• rowRolePattern : regExp
• rowRoleReplace : string
• useModelCategories : bool
• xPosRole : string
• xPosRolePattern : regExp
• xPosRoleReplace : string
• yPosRole : string
• yPosRolePattern : regExp
• yPosRoleReplace : string
• zPosRole : string
• zPosRolePattern : regExp
• zPosRoleReplace : string

Description détaillée

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

Les données sont résolues de manière asynchrone chaque fois que le mappage ou le modèle change.

Pour les enums ItemModelSurfaceDataProxy, voir QItemModelSurfaceDataProxy::MultiMatchBehavior.

Pour plus de détails, voir la documentation QItemModelSurfaceDataProxy.

Exemple d'utilisation :

ItemModelSurfaceDataProxy {
    itemModel: model // E.g. a list model defined elsewhere containing population data.
    // Mapping model roles to surface series rows, columns, and values.
    rowRole: "longitude"
    columnRole: "latitude"
    valueRole: "pop_density"
}

Voir également SurfaceDataProxy et Qt Data Visualization Data Handling.

Documentation sur les propriétés

autoColumnCategories : bool

Lorsqu'il est défini sur true, le mappage ignore toutes les catégories de colonnes 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. Les valeurs minimales et maximales des colonnes sont également générées automatiquement à partir des données lorsque l'option est réglée sur true. La valeur par défaut est true.

autoRowCategories : bool

Lorsqu'il est défini sur 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. Les valeurs minimales et maximales des lignes sont également générées automatiquement à partir des données lorsque cette valeur est définie sur true. La valeur par défaut est true.

columnCategories : list<String>

Les catégories de colonnes du mappage. Seuls les éléments dont les rôles 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 de modèle d'élément à mettre en correspondance avec la catégorie de colonne. Outre la définition de la colonne à laquelle les données appartiennent, la valeur indiquée par le rôle de colonne est également définie comme la valeur de la coordonnée X de QSurfaceDataItem lorsque les données du modèle sont résolues, à moins qu'un rôle de position x distinct ne soit également défini.

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 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 et la propriété columnRoleReplace contient la chaîne de remplacement.

Voir également columnRole et columnRoleReplace.

columnRoleReplace : string

Le contenu de remplacement à utiliser en conjonction 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 d'élément utilisé comme source de données pour Surface3D.

multiMatchBehavior : ItemModelSurfaceDataProxy.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 ItemModelSurfaceDataProxy.MMBLast.

Par exemple, vous pouvez avoir un modèle d'élément avec des données horodatées prises à des intervalles irréguliers et vous voulez visualiser une position moyenne des éléments de données à chaque heure avec un graphique de surface. Pour ce faire, spécifiez les catégories de lignes et de colonnes de manière à ce que chaque point de surface représente une heure, et définissez multiMatchBehavior sur ItemModelSurfaceDataProxy.MMBAverage.

rowCategories : list<String>

Les catégories de ligne de la cartographie. Seuls les éléments dont les rôles 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 de modèle d'élément à mettre en correspondance avec la catégorie de ligne. Outre la définition de la ligne à laquelle les données appartiennent, la valeur indiquée par le rôle de ligne est également définie comme la valeur de la coordonnée Z de QSurfaceDataItem lorsque les données du modèle sont résolues, à moins qu'un rôle de position z distinct ne soit également défini.

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 permettant de trouver la partie de la valeur mappée à remplacer et la propriété rowRoleReplace contient la chaîne de remplacement.

Voir également rowRole et rowRoleReplace.

rowRoleReplace : string

Le contenu de remplacement à utiliser en conjonction 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.

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. La valeur par défaut est false.

xPosRole : string

Le rôle du modèle d'élément à associer à la position X. Si ce rôle n'est pas défini, columnRole est utilisé pour déterminer la valeur de la coordonnée X des éléments QSurfaceDataItem résolus.

xPosRolePattern : 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 x position avant qu'elle ne soit utilisée comme valeur de position de l'élément. 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é xPosRoleReplace contient la chaîne de remplacement.

Voir également xPosRole et xPosRoleReplace.

xPosRoleReplace : string

Le contenu de remplacement à utiliser en conjonction avec xPosRolePattern. 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 xPosRole et xPosRolePattern.

yPosRole : string

Le rôle du modèle d'élément à mettre en correspondance avec la position Y.

yPosRolePattern : 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 position y avant qu'elle ne soit utilisée comme valeur de position de l'élément. 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é yPosRoleReplace contient la chaîne de remplacement.

Voir également yPosRole et yPosRoleReplace.

yPosRoleReplace : string

Le contenu de remplacement à utiliser en conjonction avec yPosRolePattern. 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 yPosRole et yPosRolePattern.

zPosRole : string

Le rôle du modèle d'élément à associer à la position Z. Si ce rôle n'est pas défini, rowRole est utilisé pour déterminer la valeur de la coordonnée Z des éléments QSurfaceDataItem résolus.

zPosRolePattern : 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 z position avant qu'elle ne soit utilisée comme valeur de position de l'élément. 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é zPosRoleReplace contient la chaîne de remplacement.

Voir également zPosRole et zPosRoleReplace.

zPosRoleReplace : string

Le contenu de remplacement à utiliser en conjonction avec zPosRolePattern. 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 zPosRole et zPosRolePattern.