QItemModelSurfaceDataProxy Class

QItemModelSurfaceDataProxy *proxy = new QItemModelSurfaceDataProxy(customModel,
                                                                   QStringLiteral("longitude"), // Row role
                                                                   QStringLiteral("latitude"), // Column role
                                                                   QStringLiteral("height")); // Y-position role

Documentation sur les propriétés

autoColumnCategories : bool

Cette propriété s'applique que les catégories de colonnes soient générées automatiquement ou non.

Lorsqu'elle est définie sur « true », la mise en correspondance ignore toutes les catégories de colonnes définies explicitement et les remplace par celles générées automatiquement à chaque fois que les données du modèle sont résolues. La valeur par défaut est « true ».

Fonctions d'accès :

Signal de notification :

autoRowCategories : bool

Cette propriété s'applique que les catégories de lignes soient générées automatiquement ou non.

Lorsqu’elle est définie sur « true », la mise en correspondance ignore toutes les catégories de lignes définies explicitement et les remplace par celles générées automatiquement à chaque fois que les données du modèle sont résolues. La valeur par défaut est « true ».

Fonctions d’accès :

Signal de notification :

columnCategories : QStringList

Cette propriété contient les catégories de colonnes pour le mappage.

Fonctions d'accès :

Signal de notification :

columnRole : QString

Cette propriété définit le rôle du modèle d'élément à associer à 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 « column » est également définie comme valeur de 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.

Fonctions d'accès :

Signal de notification :

columnRolePattern : QRegularExpression

Cette propriété indique si une opération de recherche et de remplacement est effectuée 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 repérer la partie de la valeur mappée à remplacer, tandis que la propriété « columnRoleReplace » contient la chaîne de remplacement.

Fonctions d'accès :

Signal de notification :

Voir également « columnRole » et « columnRoleReplace ».

columnRoleReplace : QString

Cette propriété contient le contenu de remplacement à utiliser en association avec un modèle de rôle de colonne.

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).

Fonctions d’accès :

Signal de notification :

Voir également columnRole et columnRolePattern.

itemModel : QAbstractItemModel*

Cette propriété contient le modèle d'élément utilisé comme source de données pour la surface 3D.

Fonctions d'accès :

Signal de notification :

multiMatchBehavior : MultiMatchBehavior

Comment sont gérées les correspondances multiples pour chaque combinaison ligne/colonne.

La valeur par défaut est « MMBLast ».

Par exemple, vous pouvez disposer d’un modèle d’éléments contenant des données horodatées relevées à intervalles irréguliers et souhaiter visualiser la position moyenne des éléments de données toutes les heures à l’aide d’un graphique de surface. Pour ce faire, spécifiez des catégories de lignes et de colonnes de manière à ce que chaque point de la surface représente une heure, puis définissez cette propriété sur « MMBAverage ».

Fonctions d’accès :

Signal de notification :

rowCategories : QStringList

Cette propriété contient les catégories de lignes pour le mappage.

Fonctions d'accès :

Signal de notification :

rowRole : QString

Cette propriété définit le rôle du modèle d'élément à associer à la catégorie de ligne.

Outre la définition de la ligne à laquelle appartiennent les données, 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.

Fonctions d'accès :

Signal de notification :

rowRolePattern : QRegularExpression

Cette propriété indique si une opération de recherche et de remplacement est effectuée sur la valeur associée au 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 repérer la partie de la valeur mappée à remplacer, tandis que la propriété « rowRoleReplace » contient la chaîne de remplacement.

Fonctions d’accès :

Signal de notification :

Voir également « rowRole » et « rowRoleReplace ».

rowRoleReplace : QString

Cette propriété contient le contenu de remplacement à utiliser avec le modèle de rôle « row ».

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).

Fonctions d’accès :

Signal de notification :

Voir également rowRole et rowRolePattern.

useModelCategories : bool

Cette propriété s'applique que les rôles et catégories de lignes et de colonnes soient utilisés ou non pour le mappage.

Lorsqu’elle est définie sur « true », la mise en correspondance ignore les rôles et les catégories de lignes et de colonnes, et utilise à la place les lignes et les colonnes du modèle. La valeur par défaut est « false ».

Fonctions d'accès :

Signal de notification :

xPosRole : QString

Cette propriété joue le rôle de modèle d'élément permettant de mapper la position X.

Si ce rôle n'est pas défini, la méthode « columnRole » est utilisée pour déterminer la valeur de la coordonnée X des objets QSurfaceDataItem s résolus.

Fonctions d'accès :

Signal de notification :

xPosRolePattern : QRegularExpression

Cette propriété indique si une opération de recherche et de remplacement est effectuée sur la valeur associée au rôle de position x avant qu'elle ne soit utilisée comme valeur de position d'élément.

Cette propriété spécifie l'expression régulière permettant de repérer la partie de la valeur mappée à remplacer, tandis que la propriété « xPosRoleReplace » contient la chaîne de remplacement.

Fonctions d’accès :

Signal de notification :

Voir également « xPosRole » et « xPosRoleReplace ».

xPosRoleReplace : QString

Cette propriété contient le contenu de remplacement à utiliser avec un modèle de rôle de position x.

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).

Fonctions d’accès :

Signal de notification :

Voir également xPosRole et xPosRolePattern.

yPosRole : QString

Cette propriété joue le rôle de modèle d'élément permettant de mapper la position Y.

Fonctions d'accès :

Signal de notification :

yPosRolePattern : QRegularExpression

Cette propriété indique si une opération de recherche et de remplacement est effectuée sur la valeur associée au rôle « position y » avant qu’elle 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.

Fonctions d’accès :

Signal de notification :

Voir également yPosRole et yPosRoleReplace.

yPosRoleReplace : QString

Cette propriété contient le contenu de remplacement à utiliser en association avec un modèle de rôle de position « y ».

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).

Fonctions d’accès :

Signal de notification :

Voir également yPosRole et yPosRolePattern.

zPosRole : QString

Cette propriété définit le rôle du modèle d'élément à associer à la position Z.

Si ce rôle n'est pas défini, la fonction « rowRole » est utilisée pour déterminer la valeur de la coordonnée Z des objets résolus QSurfaceDataItem.

Fonctions d'accès :

Signal de notification :

zPosRolePattern : QRegularExpression

Cette propriété indique si une opération de recherche et de remplacement est effectuée sur la valeur mappée par le rôle « z position » avant qu'elle 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.

Fonctions d'accès :

Signal de notification :

Voir également « zPosRole » et « zPosRoleReplace ».

zPosRoleReplace : QString

Cette propriété contient le contenu de remplacement à utiliser en association avec un modèle de rôle de position z.

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).

Fonctions d’accès :

Signal de notification :

Voir également zPosRole et zPosRolePattern.