ItemModelSurfaceDataProxy QML Type

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

• Liste de tous les membres, y compris les membres hérités
• ItemModelSurfaceDataProxy 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
• rowCategories : list<String>
• rowRole : string
• rowRolePattern : regExp
• rowRoleReplace : string
• type : AbstractDataProxy.DataType
• useModelCategories : bool
• xPosRole : string
• xPosRolePattern : regExp
• xPosRoleReplace : string
• yPosRole : string
• yPosRolePattern : regExp
• yPosRoleReplace : string
• zPosRole : string
• zPosRolePattern : regExp
• zPosRoleReplace : string

Signaux

• autoColumnCategoriesChanged(bool enable)
• autoRowCategoriesChanged(bool enable)
• columnCategoriesChanged()
• columnRoleChanged(string role)
• columnRolePatternChanged(regExp pattern)
• columnRoleReplaceChanged(string replace)
• itemModelChanged(model itemModel)
• multiMatchBehaviorChanged(enumeration behavior)
• rowCategoriesChanged()
• rowRoleChanged(string role)
• rowRolePatternChanged(regExp pattern)
• rowRoleReplaceChanged(string replace)
• useModelCategoriesChanged(bool enable)
• xPosRoleChanged(string role)
• xPosRolePatternChanged(regExp pattern)
• xPosRoleReplaceChanged(string replace)
• yPosRoleChanged(string role)
• yPosRolePatternChanged(regExp pattern)
• yPosRoleReplaceChanged(string replace)
• zPosRoleChanged(string role)
• zPosRolePatternChanged(regExp pattern)
• zPosRoleReplaceChanged(string replace)

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 Qt Graphs Gestion des données en 3D.

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

columnRole : string

Le rôle « item » du modèle doit être associé à la colonne « category ». Outre le fait de définir à quelle colonne appartiennent les données, la valeur indiquée par le rôle de colonne est également définie comme la coordonnée X de l'QSurfaceDataItem e 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 avec la fonction 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 : 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 « ItemModelSurfaceDataProxy.MultiMatchBehavior.Last ».

Par exemple, imaginons que vous disposiez d’un modèle d’éléments contenant des données horodatées collectées à des 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, il suffit de 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 de définir multiMatchBehavior sur ItemModelSurfaceDataProxy.MultiMatchBehavior.Average.

rowCategories : list<String>

Les catégories de lignes du mappage. Seuls les éléments dont le rôle de ligne figure 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 « item » du modèle permet d'établir une correspondance avec la catégorie de ligne. Outre le fait de définir à quelle ligne 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.

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 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. 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 valeur de 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 « x-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 repérer 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 « 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 repérer 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 QSurfaceDataItem résolus.

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

Contenu de remplacement à utiliser avec la fonction ` 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.

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 l'columnRole passe à role.

columnRolePatternChanged(regExp pattern)

Ce signal est émis lorsque 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.

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.

xPosRoleChanged(string role)

Ce signal est émis lorsque xPosRole devient role.

xPosRolePatternChanged(regExp pattern)

Ce signal est émis lorsque xPosRolePattern devient pattern.

xPosRoleReplaceChanged(string replace)

Ce signal est émis lorsque xPosRoleReplace devient replace.

yPosRoleChanged(string role)

Ce signal est émis lorsque yPosRole devient role.

yPosRolePatternChanged(regExp pattern)

Ce signal est émis lorsque yPosRolePattern devient pattern.

yPosRoleReplaceChanged(string replace)

Ce signal est émis lorsque yPosRoleReplace devient replace.

zPosRoleChanged(string role)

Ce signal est émis lorsque zPosRole devient role.

zPosRolePatternChanged(regExp pattern)

Ce signal est émis lorsque zPosRolePattern devient pattern.

zPosRoleReplaceChanged(string replace)

Ce signal est émis lorsque zPosRoleReplace devient replace.