Sur cette page

ItemModelScatterDataProxy QML Type

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

Import Statement: import QtDataVisualization 1.12
Since: QtDataVisualization 1.0
In C++: QItemModelScatterDataProxy
Inherits:

ScatterDataProxy

Status: Deprecated

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

Propriétés

Description détaillée

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

Les données sont résolues de manière asynchrone dès qu'un changement intervient au niveau du mappage ou du modèle. L'événement QScatterDataProxy::arrayReset() est déclenché une fois les données résolues.

Pour plus de détails, consultez la documentation d'QItemModelScatterDataProxy.

Exemple d'utilisation :

ItemModelScatterDataProxy {
    itemModel: model // E.g. a list model defined elsewhere containing point coordinates.
    // Mapping model roles to scatter series item coordinates.
    xPosRole: "xPos"
    yPosRole: "yPos"
    zPosRole: "zPos"
}

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

Documentation sur les propriétés

itemModel : model

Le modèle d'élément à utiliser comme source de données pour Scatter3D.

rotationRole : string

Le rôle du modèle d'élément à associer à la rotation de l'élément. Le modèle peut fournir la valeur de rotation soit sous la forme d'une variante directement convertible en ` quaternion`, soit sous l'une des représentations sous forme de chaîne suivantes : ` "scalar,x,y,z" ` ou ` "@angle,x,y,z"`. Le premier format permettra de construire directement l'objet ` quaternion ` à partir des valeurs fournies, tandis que le second permettra de construire l'objet ` quaternion ` à l'aide de la méthode ` QQuaternion::fromAxisAndAngle()`.

rotationRolePattern : regExp

Lorsqu’elle est définie, une opération de recherche et de remplacement est effectuée sur la valeur associée par le rôle de rotation avant que celle-ci ne soit utilisée pour la rotation de l’élément. Cette propriété spécifie l’expression régulière permettant de rechercher la partie de la valeur associé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.

xPosRole : string

Le rôle du modèle d'élément à mapper à la position X.

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 rechercher 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

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

Cette propriété définit le contenu de remplacement à utiliser avec la méthode ` 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 à mapper à la position Z.

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 « z position » 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

Cette propriété définit le contenu de remplacement à utiliser avec la méthode ` 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 de la fonction ` QString::replace` (const QRegularExpression &rx, const QString &after).

Voir également zPosRole et zPosRolePattern.

© 2026 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.