Sur cette page

QCandlestickSeries Class

La classe QCandlestickSeries présente des données sous forme de chandeliers. Plus d'informations...

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

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 chandeliers. Chaque élément est dessiné dans sa propre catégorie lors de l'utilisation de QBarCategoryAxis. QDateTimeAxis et QValueAxis peuvent être utilisés comme alternatives à QBarCategoryAxis. Dans ce cas, chaque élément de chandelier est dessiné en fonction de sa valeur d'horodatage.

Remarque : les horodatages doivent être uniques au sein d'une QCandlestickSeries. Lors de l'utilisation de QBarCategoryAxis, seul le premier des chandeliers partageant un horodatage est dessiné. Si le graphique comprend plusieurs instances de QCandlestickSeries, les éléments de différentes séries partageant un horodatage sont dessinés dans la même catégorie. Lors de l'utilisation de QValueAxis ou QDateTimeAxis, les éléments de chandelier partageant un horodatage se chevaucheront.

Consultez la galerie Charts with Widgets pour apprendre à créer un graphique en chandelier.

Voir également QCandlestickSet, QBarCategoryAxis, QDateTimeAxis, et QValueAxis.

Documentation sur les propriétés

bodyOutlineVisible : bool

Cette propriété définit la visibilité du contour du corps du chandelier.

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 du chandelier à l'intérieur de son propre emplacement, dans une fourchette comprise entre 0,0 et 1,0.

Les valeurs en dehors de cette plage sont fixé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 la brosse utilisée pour remplir les éléments du chandelier.

Fonctions d'accès :

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

Signal de notification :

void brushChanged()

capsVisible : bool

Cette propriété indique la visibilité des bouchons.

Fonctions d'accès :

bool capsVisible() const
void setCapsVisible(bool capsVisible)

Signal du notificateur :

capsWidth : qreal

Cette propriété définit la largeur relative des capuchons à l'intérieur d'un chandelier, dans une fourchette de 0,0 à 1,0.

Les valeurs en dehors de cette plage sont fixé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é contient le nombre d'éléments de chandelier 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 l'élément du chandelier décroissant.

Un chandelier est décroissant lorsque sa valeur d'ouverture est supérieure à sa valeur de fermeture. Par défaut, cette propriété est définie sur la couleur du pinceau, le canal alpha étant défini 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 l'élément du chandelier croissant.

Un chandelier est croissant 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é indique la largeur maximale des éléments du chandelier en pixels. Une valeur négative signifie 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 du chandelier en pixels. Une valeur négative signifie 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 dessiner les lignes des chandeliers.

Fonctions d'accès :

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

Signal de notification :

void penChanged()

Fonction membre Documentation

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

Construit un QCandlestickSeries vide. L'adresse parent est facultative.

[virtual noexcept] QCandlestickSeries::~QCandlestickSeries()

Détruit la série. Supprime la série du graphique.

bool QCandlestickSeries::append(QCandlestickSet *set)

Ajoute un seul élément de chandelier spécifié par set à la série et en prend la propriété. Si l'élément est nul ou s'il se trouve 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 une liste d'éléments de chandelier spécifiés par sets à la série et en prend possession. Si l'un des éléments est nul, appartient déjà à la série ou apparaît dans la liste plus d'une fois, 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 l'élément du chandelier change.

Note : Signal de notification pour la propriété bodyOutlineVisible.

Voir également bodyOutlineVisible.

[signal] void QCandlestickSeries::bodyWidthChanged()

Ce signal est émis lorsque la largeur de l'élément du chandelier change.

Note : Signal de notification pour la propriété bodyWidth.

Voir également bodyWidth.

[signal] void QCandlestickSeries::brushChanged()

Ce signal est émis lorsque la brosse de l'élément chandelier change.

Note : Signal de notification pour la propriété brush.

Voir également brush.

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

Ce signal est émis lorsque les chandeliers 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 chandeliers spécifiés par sets sont supprimés de la série.

[signal] void QCandlestickSeries::capsVisibilityChanged()

Ce signal est émis lorsque la visibilité des capuchons de l'élément chandelier change.

Note : Signal de notification pour la propriété capsVisible.

Voir également capsVisible.

[signal] void QCandlestickSeries::capsWidthChanged()

Ce signal est émis lorsque la largeur des capuchons de l'élément de chandelier change.

Note : Signal de notification pour la propriété capsWidth.

Voir également capsWidth.

void QCandlestickSeries::clear()

Supprime tous les chandeliers de la série et les efface définitivement.

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

Ce signal est émis lorsque l'élément de chandelier spécifié par set est cliqué sur le graphique.

int QCandlestickSeries::count() const

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

Remarque : fonction Getter pour la propriété count.

[signal] void QCandlestickSeries::countChanged()

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

Note : Signal de notification pour la propriété count.

Voir également count.

[signal] void QCandlestickSeries::decreasingColorChanged()

Ce signal est émis lorsque la couleur décroissante de l'élément du chandelier change.

Note : Signal de notification pour la propriété decreasingColor.

Voir également decreasingColor.

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

Ce signal est émis lorsque l'élément de chandelier spécifié par set est double-cliqué sur le graphique.

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

Ce signal est émis lorsque la souris passe sur l'élément de chandelier spécifié par set dans un graphique.

Lorsque la souris passe au-dessus de l'élément, status devient true, et lorsque la souris s'éloigne à nouveau, il devient false.

[signal] void QCandlestickSeries::increasingColorChanged()

Ce signal est émis lorsque la couleur croissante de l'élément du chandelier change.

Note : Signal de notification pour la propriété increasingColor.

Voir également increasingColor.

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

Insère l'élément de chandelier spécifié par set dans la série à la position spécifiée par index. L'élément devient la propriété de l'utilisateur. Si l'élément est nul ou appartient déjà à la série, il n'est pas inséré. Retourne true si l'insertion a réussi, false sinon.

[signal] void QCandlestickSeries::maximumColumnWidthChanged()

Ce signal est émis lorsqu'il y a un changement dans la largeur maximale de la colonne des éléments de chandelier.

Note : Signal de notification pour la propriété maximumColumnWidth.

Voir également maximumColumnWidth.

[signal] void QCandlestickSeries::minimumColumnWidthChanged()

Ce signal est émis lorsqu'il y a un changement dans la largeur minimale de la colonne des éléments de chandelier.

Note : Signal de notification pour la propriété minimumColumnWidth.

Voir également minimumColumnWidth.

[signal] void QCandlestickSeries::penChanged()

Ce signal est émis lorsque le stylo de l'élément chandelier change.

Note : Signal de notification pour la propriété pen.

Voir également pen.

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

Ce signal est émis lorsque l'utilisateur clique sur l'élément du chandelier spécifié 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 la pression de la souris sur l'élément du chandelier spécifié par set.

bool QCandlestickSeries::remove(QCandlestickSet *set)

Supprime un seul é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 chandelier 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 dans la liste plus d'une fois, 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 chandeliers de la série. La propriété des éléments ne change pas.

bool QCandlestickSeries::take(QCandlestickSet *set)

Prend un seul élément de chandelier, spécifié par set, dans la série. Ne supprime pas l'élément. Renvoie true si l'opération d'extraction 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 qu'il devienne propriétaire.

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

Réimplémente une fonction d'accès à 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.