Sur cette page

QCandlestickSeries Class

La classe `QCandlestickSeries` affiche les données sous forme de chandeliers. En savoir plus...

Header: #include <QCandlestickSeries>
In QML: CandlestickSeries
Inherits: QAbstractSeries
Status: Deprecated

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

Propriétés

Fonctions publiques

QCandlestickSeries(QObject *parent = nullptr)
virtual ~QCandlestickSeries()
bool append(QCandlestickSet *set)
bool append(const QList<QCandlestickSet *> &sets)
bool bodyOutlineVisible() const
qreal bodyWidth() const
QBrush brush() const
bool capsVisible() const
qreal capsWidth() const
void clear()
int count() const
QColor decreasingColor() const
QColor increasingColor() const
bool insert(int index, QCandlestickSet *set)
qreal maximumColumnWidth() const
qreal minimumColumnWidth() const
QPen pen() const
bool remove(QCandlestickSet *set)
bool remove(const QList<QCandlestickSet *> &sets)
void setBodyOutlineVisible(bool bodyOutlineVisible)
void setBodyWidth(qreal bodyWidth)
void setBrush(const QBrush &brush)
void setCapsVisible(bool capsVisible)
void setCapsWidth(qreal capsWidth)
void setDecreasingColor(const QColor &decreasingColor)
void setIncreasingColor(const QColor &increasingColor)
void setMaximumColumnWidth(qreal maximumColumnWidth)
void setMinimumColumnWidth(qreal minimumColumnWidth)
void setPen(const QPen &pen)
QList<QCandlestickSet *> sets() const
bool take(QCandlestickSet *set)

Fonctions publiques réimplémentées

virtual QAbstractSeries::SeriesType type() const override

Signaux

void bodyOutlineVisibilityChanged()
void bodyWidthChanged()
void brushChanged()
void candlestickSetsAdded(const QList<QCandlestickSet *> &sets)
void candlestickSetsRemoved(const QList<QCandlestickSet *> &sets)
void capsVisibilityChanged()
void capsWidthChanged()
void clicked(QCandlestickSet *set)
void countChanged()
void decreasingColorChanged()
void doubleClicked(QCandlestickSet *set)
void hovered(bool status, QCandlestickSet *set)
void increasingColorChanged()
void maximumColumnWidthChanged()
void minimumColumnWidthChanged()
void penChanged()
void pressed(QCandlestickSet *set)
void released(QCandlestickSet *set)

Description détaillée

Cette classe sert de conteneur pour les éléments de chandeliers individuels. Chaque élément est tracé dans sa propre catégorie lors de l’utilisation de ` QBarCategoryAxis`. Les méthodes ` QDateTimeAxis ` et ` QValueAxis ` peuvent être utilisées à la place de ` QBarCategoryAxis`. Dans ce cas, chaque élément de chandelier est tracé en fonction de la valeur de son horodatage.

Remarque : les horodatages doivent être uniques au sein d’une instance de `QCandlestickSeries`. Lorsque vous utilisez QBarCategoryAxis, seul le premier élément de chandelier partageant un horodatage est tracé. Si le graphique comprend plusieurs instances de QCandlestickSeries, les éléments de séries différentes partageant un horodatage sont tracés dans la même catégorie. Lorsque vous utilisez QValueAxis ou QDateTimeAxis, les éléments de chandelier partageant un horodatage se chevauchent.

Consultez la galerie « Charts with Widgets » pour découvrir comment créer un graphique en chandeliers.

Graphique en chandeliers représentant les cours quotidiens d'une action, avec des chandeliers verts indiquant une hausse et des chandeliers rouges indiquant une baisse, sur une période d'un mois

Voir également QCandlestickSet, QBarCategoryAxis, QDateTimeAxis et QValueAxis.

Documentation sur les propriétés

bodyOutlineVisible : bool

Cette propriété détermine la visibilité du contour du corps de la bougie.

Fonctions d'accès :

bool bodyOutlineVisible() const
void setBodyOutlineVisible(bool bodyOutlineVisible)

Signal de notification :

bodyWidth : qreal

Cette propriété définit la largeur relative de l'élément « chandelier » au sein de son propre emplacement, dans une plage comprise entre 0,0 et 1,0.

Les valeurs situées en dehors de cette plage sont limitées à 0,0 ou 1,0.

Fonctions d'accès :

qreal bodyWidth() const
void setBodyWidth(qreal bodyWidth)

Signal de notification :

brush : QBrush

Cette propriété contient le pinceau utilisé pour remplir les éléments de chandelier.

Fonctions d'accès :

QBrush brush() const
void setBrush(const QBrush &brush)

Signal de notification :

void brushChanged()

capsVisible : bool

Cette propriété détermine la visibilité des majuscules.

Fonctions d'accès :

bool capsVisible() const
void setCapsVisible(bool capsVisible)

Signal de notification :

capsWidth : qreal

Cette propriété indique la largeur relative des sommets au sein d'un chandelier, dans une plage comprise entre 0,0 et 1,0.

Les valeurs situées en dehors de cette plage sont limitées à 0,0 ou 1,0.

Fonctions d'accès :

qreal capsWidth() const
void setCapsWidth(qreal capsWidth)

Signal de notification :

[read-only] count : int

Cette propriété indique le nombre de chandeliers dans une série.

Fonctions d’accès :

int count() const

Signal de notification :

void countChanged()

decreasingColor : QColor

Cette propriété définit la couleur du corps de la bougie baissière.

Une bougie est baissière lorsque sa valeur d'ouverture est supérieure à sa valeur de clôture. Par défaut, cette propriété est définie sur la couleur du pinceau, avec le canal alpha réglé sur 128. La couleur par défaut est également utilisée lorsque la propriété est définie sur une valeur de couleur non valide.

Fonctions d’accès :

QColor decreasingColor() const
void setDecreasingColor(const QColor &decreasingColor)

Signal de notification :

increasingColor : QColor

Cette propriété définit la couleur du corps de la bougie haussière.

Une bougie est dite haussière lorsque sa valeur de clôture est supérieure à sa valeur d'ouverture. Par défaut, cette propriété est définie sur la couleur du pinceau. La couleur par défaut est également utilisée lorsque la propriété est définie sur une valeur de couleur non valide.

Fonctions d'accès :

QColor increasingColor() const
void setIncreasingColor(const QColor &increasingColor)

Signal de notification :

maximumColumnWidth : qreal

Cette propriété définit la largeur maximale des éléments de chandelier en pixels. Une valeur négative indique qu'il n'y a pas de largeur maximale. Toutes les valeurs négatives sont converties en -1,0.

Fonctions d'accès :

qreal maximumColumnWidth() const
void setMaximumColumnWidth(qreal maximumColumnWidth)

Signal de notification :

minimumColumnWidth : qreal

Cette propriété définit la largeur minimale des éléments de chandelier en pixels. Une valeur négative indique qu’il n’y a pas de largeur minimale. Toutes les valeurs négatives sont converties en -1,0.

Fonctions d'accès :

qreal minimumColumnWidth() const
void setMinimumColumnWidth(qreal minimumColumnWidth)

Signal de notification :

pen : QPen

Cette propriété contient le stylo utilisé pour tracer les lignes des éléments de chandeliers.

Fonctions d'accès :

QPen pen() const
void setPen(const QPen &pen)

Signal de notification :

void penChanged()

Documentation des fonctions membres

[explicit] QCandlestickSeries::QCandlestickSeries(QObject *parent = nullptr)

Crée un objet `QCandlestickSeries` vide. Le paramètre ` parent ` est facultatif.

[virtual noexcept] QCandlestickSeries::~QCandlestickSeries()

Supprime la série. Retire la série du graphique.

bool QCandlestickSeries::append(QCandlestickSet *set)

Ajoute à la série un élément de chandelier spécifié par ` set ` et en prend la propriété. Si l'élément est nul ou s'il figure déjà dans la série, il n'est pas ajouté. Renvoie ` true ` si l'ajout a réussi, ` false ` dans le cas contraire.

bool QCandlestickSeries::append(const QList<QCandlestickSet *> &sets)

Ajoute à la série une liste d'éléments de chandeliers spécifiés par ` sets ` et en prend la propriété. Si l'un des éléments est nul, appartient déjà à la série ou apparaît plusieurs fois dans la liste, rien n'est ajouté. Renvoie ` true ` si tous les éléments ont été ajoutés avec succès, ` false ` dans le cas contraire.

[signal] void QCandlestickSeries::bodyOutlineVisibilityChanged()

Ce signal est émis lorsque la visibilité du contour du corps de la bougie change.

Remarque : signalde notification pour la propriété bodyOutlineVisible.

Voir également bodyOutlineVisible.

[signal] void QCandlestickSeries::bodyWidthChanged()

Ce signal est émis lorsque la largeur de la bougie change.

Remarque : signalde notification pour la propriété bodyWidth.

Voir également bodyWidth.

[signal] void QCandlestickSeries::brushChanged()

Ce signal est émis lorsque le pinceau de l'élément « chandelier » change.

Remarque : signalde notification pour la propriété brush.

Voir également brush.

[signal] void QCandlestickSeries::candlestickSetsAdded(const QList<QCandlestickSet *> &sets)

Ce signal est émis lorsque les éléments de chandelier spécifiés par sets sont ajoutés à la série.

[signal] void QCandlestickSeries::candlestickSetsRemoved(const QList<QCandlestickSet *> &sets)

Ce signal est émis lorsque les éléments de chandeliers indiqués par ` sets ` sont supprimés de la série.

[signal] void QCandlestickSeries::capsVisibilityChanged()

Ce signal est émis lorsque la visibilité des chapeaux des chandeliers change.

Remarque : signalde notification pour la propriété capsVisible.

Voir également capsVisible.

[signal] void QCandlestickSeries::capsWidthChanged()

Ce signal est émis lorsque la largeur de la bougie change.

Remarque : signalde notification pour la propriété capsWidth.

Voir également capsWidth.

void QCandlestickSeries::clear()

Supprime tous les éléments de type « chandelier » de la série et les efface définitivement.

[signal] void QCandlestickSeries::clicked(QCandlestickSet *set)

Ce signal est émis lorsqu'on clique sur le chandelier spécifié par « set » sur le graphique.

int QCandlestickSeries::count() const

Renvoie le nombre d'éléments de chandeliers dans la série.

Remarque : fonctiongetter pour la propriété count.

[signal] void QCandlestickSeries::countChanged()

Ce signal est émis lorsque le nombre de bougies dans la série change.

Remarque : signalde notification pour la propriété count.

Voir également count.

[signal] void QCandlestickSeries::decreasingColorChanged()

Ce signal est émis lorsque la couleur de l'élément « chandelier » change et s'assombrit.

Remarque : signalde notification pour la propriété decreasingColor.

Voir également decreasingColor.

[signal] void QCandlestickSeries::doubleClicked(QCandlestickSet *set)

Ce signal est émis lorsqu'on double-clique sur le chandelier spécifié par l'set e dans le graphique.

[signal] void QCandlestickSeries::hovered(bool status, QCandlestickSet *set)

Ce signal est émis lorsqu'on passe la souris sur la bougie spécifiée par set dans un graphique.

Lorsque la souris passe sur l'élément, status devient true, et lorsque la souris s'en éloigne, il redevient false.

[signal] void QCandlestickSeries::increasingColorChanged()

Ce signal est émis lorsque la couleur de l'élément « bougie » change.

Remarque : signalde notification pour la propriété increasingColor.

Voir également increasingColor.

bool QCandlestickSeries::insert(int index, QCandlestickSet *set)

Insère l'élément « chandelier » spécifié par ` set ` dans la série à la position indiquée par ` index`. Prend possession de l'élément. Si l'élément est nul ou appartient déjà à la série, il n'est pas inséré. Renvoie ` true ` si l'insertion a réussi, ` false ` dans le cas contraire.

[signal] void QCandlestickSeries::maximumColumnWidthChanged()

Ce signal est émis lorsqu'un changement intervient au niveau de la largeur maximale des colonnes des éléments de chandeliers.

Remarque : signalde notification pour la propriété maximumColumnWidth.

Voir également maximumColumnWidth.

[signal] void QCandlestickSeries::minimumColumnWidthChanged()

Ce signal est émis lorsqu'un changement intervient au niveau de la largeur minimale des colonnes des éléments de chandeliers japonais.

Remarque : signalde notification pour la propriété minimumColumnWidth.

Voir également minimumColumnWidth.

[signal] void QCandlestickSeries::penChanged()

Ce signal est émis lorsque l'outil de dessin des chandeliers change.

Remarque : signalde notification pour la propriété pen.

Voir également pen.

[signal] void QCandlestickSeries::pressed(QCandlestickSet *set)

Ce signal est émis lorsque l'utilisateur clique sur la bougie spécifiée par set et maintient le bouton de la souris enfoncé.

[signal] void QCandlestickSeries::released(QCandlestickSet *set)

Ce signal est émis lorsque l'utilisateur relâche le bouton de la souris sur le chandelier spécifié par set.

bool QCandlestickSeries::remove(QCandlestickSet *set)

Supprime un élément de chandelier, spécifié par ` set`, de la série. Renvoie ` true ` si l'élément est supprimé avec succès, ` false ` dans le cas contraire.

bool QCandlestickSeries::remove(const QList<QCandlestickSet *> &sets)

Supprime de la série une liste d’éléments de chandeliers spécifiés par sets. Si l’un des éléments est nul, a déjà été supprimé de la série ou apparaît plusieurs fois dans la liste, rien n’est supprimé. Renvoie true si tous les éléments ont été supprimés avec succès, false dans le cas contraire.

QList<QCandlestickSet *> QCandlestickSeries::sets() const

Renvoie la liste des éléments de chandeliers de la série. La propriété de ces éléments reste inchangée.

bool QCandlestickSeries::take(QCandlestickSet *set)

Récupère un élément de chandelier unique, spécifié par set, à partir de la série. Ne supprime pas l'élément. Renvoie true si l'opération de récupération a réussi, false dans le cas contraire.

Remarque : la série reste l'objet parent de l'élément. Vous devez définir l'objet parent pour en prendre la pleine propriété.

[override virtual] QAbstractSeries::SeriesType QCandlestickSeries::type() const

Réimplémente une fonction d'accès pour la propriété : QAbstractSeries::type.

Renvoie le type de la série (QAbstractSeries::SeriesTypeCandlestick).

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