Sur cette page

VCandlestickModelMapper QML Type

Mappeur de modèle vertical pour une série de chandeliers. En savoir plus...

Import Statement: import QtCharts 2.12
Since: QtCharts 2.2
In C++: QVCandlestickModelMapper
Status: Deprecated

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

Propriétés

Description détaillée

Les mappeurs de modèles permettent d'utiliser un modèle de données dérivé de la classe QAbstractItemModel comme source de données pour un graphique. Un mappeur de modèle vertical est utilisé pour établir une connexion entre un modèle de données et CandlestickSeries, de sorte que chaque colonne du modèle de données définisse un élément de chandelier et que chaque ligne corresponde aux valeurs d’ouverture, de plus haut, de plus bas, de clôture et d’horodatage de cet élément.

Les propriétés du modèle et de la série de chandeliers peuvent toutes deux être utilisées pour manipuler les données. Le mappeur de modèle assure la synchronisation entre la série de chandeliers et le modèle de données.

Le mappeur de modèle garantit que tous les éléments de chandelier de la série de chandeliers ont la même taille. Par conséquent, l’ajout ou la suppression d’une valeur dans un élément de chandelier entraîne la même modification dans tous les éléments de chandelier de la série.

L’exemple QML suivant crée une série de chandeliers comportant trois éléments de chandelier (en supposant que le modèle comporte au moins quatre colonnes). Chaque élément de chandelier contient des données définies par les lignes « timestamp », « open », « high », « low » et « close ». Le nom d’un élément est défini par l’en-tête horizontal de la colonne.

CandlestickSeries {
    VCandlestickModelMapper {
        model: myCustomModel // QAbstractItemModel derived implementation
        timestampRow: 1
        openRow: 2
        highRow: 3
        lowRow: 4
        closeRow: 5
        firstSetColumn: 1
        lastSetColumn: 3
    }
}

Voir également CandlestickSeries, CandlestickSet et HCandlestickModelMapper.

Documentation sur les propriétés

closeRow : int

Ligne du modèle contenant les valeurs de clôture des éléments de chandelier de la série. La valeur par défaut est -1 (mappage non valide).

firstSetColumn : int

Colonne du modèle servant de source de données pour le premier élément. La valeur par défaut est -1 (mappage non valide).

highRow : int

Ligne du modèle contenant les valeurs élevées des éléments de chandelier dans la série. La valeur par défaut est -1 (mappage non valide).

lastSetColumn : int

Colonne du modèle utilisée comme source de données pour le dernier élément. La valeur par défaut est -1 (mappage non valide).

lowRow : int

Ligne du modèle contenant les valeurs les plus basses des éléments de chandelier de la série. La valeur par défaut est -1 (mappage non valide).

model : QAbstractItemModel

Le modèle basé sur « QAbstractItemModel » utilisé par le mappeur. Ce modèle doit être implémenté et exposé à QML.

Remarque : le modèle utilisé doit prendre en charge l'ajout et la suppression de lignes ou de colonnes, ainsi que la modification des données des cellules.

openRow : int

Ligne du modèle contenant les valeurs d'ouverture des éléments de chandeliers de la série. La valeur par défaut est -1 (mappage non valide).

series : CandlestickSeries

L'objet de type « CandlestickSeries » utilisé par le mappeur.

Toutes les données de la série sont supprimées lorsqu'elle est définie dans le mappeur. Lorsqu'une nouvelle série est spécifiée, l'ancienne série est déconnectée (mais ses données sont conservées).

timestampRow : int

Ligne du modèle contenant les valeurs d'horodatage des éléments de chandelier de la série. La valeur par défaut est -1 (mappage non valide).

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