ItemModelSurfaceDataProxy QML Type

Classe proxy permettant de présenter des données dans des modèles d'éléments à l'aide de ` Surface3D`. En savoir plus...

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

• 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 des modèles dérivés d'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 énumérations ItemModelSurfaceDataProxy, consultez QItemModelSurfaceDataProxy::MultiMatchBehavior.

Pour plus de détails, consultez la documentation de 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 la section « Gestion des données » deQt Data Visualization .

Documentation sur les propriétés

autoColumnCategories : bool

Lorsque ce paramètre 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. Les valeurs minimales et maximales des colonnes proxy sont également générées automatiquement à partir des données lorsque ce paramètre est défini sur « true ». La valeur par défaut est « true ».

autoRowCategories : bool

Lorsque ce paramètre 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. Les valeurs minimales et maximales de proxy pour les lignes sont également générées automatiquement à partir des données lorsque ce paramètre est défini 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 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 « item » du modèle à associer à la colonne « category ». Outre la définition de la colonne à laquelle appartiennent les données, la valeur indiquée par le rôle de colonne est également définie comme la coordonnée X de QSurfaceDataItem lors de la résolution des données du modèle, à moins qu’un rôle de position X distinct ne soit également défini.

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 que celle-ci 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.

Voir également columnRole et columnRoleReplace.

columnRoleReplace : string

Contenu de remplacement à utiliser conjointement 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, consultez la documentation relative à 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, supposons que vous disposiez d’un modèle d’éléments contenant des données horodatées collectées à intervalles irréguliers et que vous souhaitiez visualiser la position moyenne des éléments de données pour chaque heure à l’aide d’un graphique de surface. Pour ce faire, vous pouvez spécifier des catégories de lignes et de colonnes de manière à ce que chaque point de la surface représente une heure, puis définir multiMatchBehavior sur « ItemModelSurfaceDataProxy.MMBAverage ».

rowCategories : list<String>

Les catégories de lignes du mappage. Seuls les éléments dont les rôles 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 « item » du modèle permet d'établir une correspondance avec la catégorie de ligne. Outre le fait de définir à quelle ligne les données appartiennent, la valeur indiquée par le rôle « row » est également définie comme la coordonnée Z de QSurfaceDataItem lors de la résolution des données du modèle, à moins qu'un rôle de position Z distinct ne soit également défini.

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 que celle-ci 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.

Voir également rowRole et rowRoleReplace.

rowRoleReplace : string

Contenu de remplacement à utiliser avec la fonction ` 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. La valeur par défaut est « false ».

xPosRole : string

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

xPosRolePattern : 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 position x avant que celle-ci ne soit utilisée comme valeur de position d’élément. 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é xPosRoleReplace contient la chaîne de remplacement.

Voir également « xPosRole » et « xPosRoleReplace ».

xPosRoleReplace : string

Contenu de remplacement à utiliser avec la fonction ` 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, consultez la documentation relative à 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 à associer à la position Y.

yPosRolePattern : 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 position y avant que celle-ci ne soit utilisée comme valeur de position d’élément. 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é « yPosRoleReplace » contient la chaîne de remplacement.

Voir également « yPosRole » et « yPosRoleReplace ».

yPosRoleReplace : string

Contenu de remplacement à utiliser avec la fonction ` 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, consultez la documentation relative à 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, la méthode ` rowRole ` est utilisée pour déterminer la valeur de la coordonnée Z des éléments résolus de ` QSurfaceDataItem `.

zPosRolePattern : 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 position z avant que celle-ci ne soit utilisée comme valeur de position d’élément. 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é zPosRoleReplace contient la chaîne de remplacement.

Voir également zPosRole et zPosRoleReplace.

zPosRoleReplace : string

Contenu de remplacement à utiliser conjointement 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, consultez la documentation relative à la fonction QString::replace(const QRegularExpression &rx, const QString &after).

Voir également zPosRole et zPosRolePattern.