Sur cette page

CandlestickSeries QML Type

Représente une série de données sous forme de chandeliers. En savoir plus...

Import Statement: import QtCharts 2.12
Since: QtCharts 2.2
In C++: QCandlestickSeries
Inherits:

AbstractSeries

Status: Deprecated

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

Propriétés

Signaux

Méthodes

  • bool append(CandlestickSet set)
  • CandlestickSet at(int index)
  • void clear()
  • bool insert(int index, CandlestickSet set)
  • bool remove(CandlestickSet set)

Description détaillée

Le type CandlestickSeries sert de conteneur pour des éléments de chandeliers individuels. Chaque élément est tracé dans sa propre catégorie lorsque l'on utilise BarCategoryAxis. DateTimeAxis et ValueAxis peuvent être utilisés à la place de BarCategoryAxis. 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 CandlestickSeries. Lorsque vous utilisez ` BarCategoryAxis`, seul le premier des éléments de chandelier partageant un horodatage est tracé. Si le graphique comprend plusieurs instances de `CandlestickSeries`, les éléments de séries différentes partageant un horodatage sont tracés dans la même catégorie. Lorsque vous utilisez ` ValueAxis ` ou ` DateTimeAxis`, les éléments de chandelier partageant un horodatage se chevauchent.

Le code QML suivant montre comment créer un graphique en chandeliers simple :

import QtQuick 2.5
import QtCharts 2.2

ChartView {
    title: "Candlestick Series"
    width: 400
    height: 300

    CandlestickSeries {
        name: "Acme Ltd."
        increasingColor: "green"
        decreasingColor: "red"

        CandlestickSet { timestamp: 1435708800000; open: 690; high: 694; low: 599; close: 660 }
        CandlestickSet { timestamp: 1435795200000; open: 669; high: 669; low: 669; close: 669 }
        CandlestickSet { timestamp: 1436140800000; open: 485; high: 623; low: 485; close: 600 }
        CandlestickSet { timestamp: 1436227200000; open: 589; high: 615; low: 377; close: 569 }
        CandlestickSet { timestamp: 1436313600000; open: 464; high: 464; low: 254; close: 254 }
    }
}

Capture d'écran présentant un exemple de série de chandeliers japonais, l'axe des x représentant les dates et heures


Voir également CandlestickSet, BarCategoryAxis, DateTimeAxis et ValueAxis.

Documentation des propriétés

axisX : AbstractAxis

L'axe des x utilisé pour la série. Si vous ne définissez ni axisX ni axisXTop, un axe des valeurs est créé pour la série.

Voir également axisXTop et ValueAxis.

axisXTop : AbstractAxis

L'axe des x utilisé pour la série, tracé par-dessus la vue graphique.

Remarque : vous ne pouvez spécifier que l'une des options suivantes : « axisX » ou « axisXTop », mais pas les deux.

Voir également axisX.

axisY : AbstractAxis

L'axe des y utilisé pour la série. Si vous ne définissez ni axisY ni axisYRight, un axe des valeurs est créé pour la série.

Voir également axisYRight et ValueAxis.

axisYRight : AbstractAxis

L'axe des y utilisé pour la série, tracé vers la droite dans la vue graphique.

Remarque : vous ne pouvez spécifier que l'une des options suivantes : « axisY » ou « axisYRight », mais pas les deux.

Voir également axisY.

bodyOutlineVisible : bool

La visibilité des contours du corps des chandeliers.

bodyWidth : real

Largeur relative de l'élément « chandelier » au sein de son propre emplacement, comprise entre 0,0 et 1,0. Les valeurs situées en dehors de cette plage sont limitées à 0,0 ou 1,0.

brushFilename : string

Nom du fichier utilisé comme image de pinceau pour la série.

capsVisible : bool

La visibilité des casquettes.

capsWidth : real

Largeur relative des « chapeaux » d'une bougie, comprise entre 0,0 et 1,0. Les valeurs situées en dehors de cette plage sont limitées à 0,0 ou 1,0.

count : int [read-only]

Nombre d'éléments de chandeliers dans une série.

decreasingColor : color

Couleur du corps d'une bougie baissière. Une bougie est baissière lorsque son cours d'ouverture est supérieur à son cours de clôture. Par défaut, cette propriété est définie sur la couleur du pinceau, avec un canal alpha fixé à 128. La couleur par défaut est également utilisée lorsque la propriété est définie sur une valeur de couleur non valide.

increasingColor : color

Couleur du corps d'un chandelier haussier. Un chandelier est haussier lorsque son cours de clôture est supérieur à son cours 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.

maximumColumnWidth : real

Largeur maximale des éléments de chandelier, exprimée en pixels. Si vous définissez une valeur négative, cela signifie qu’il n’y a pas de largeur maximale. Toutes les valeurs négatives sont converties en -1,0.

minimumColumnWidth : real

Largeur minimale des éléments de 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.

Documentation sur Signal

candlestickSetsAdded(list<CandlestickSet> sets)

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

Le gestionnaire de signal correspondant est onCandlestickSetsAdded.

Remarque : le gestionnaire correspondant est onCandlestickSetsAdded.

candlestickSetsRemoved(list<CandlestickSet> sets)

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

Le gestionnaire de signal correspondant est onCandlestickSetsRemoved.

Remarque : le gestionnaire correspondant est onCandlestickSetsRemoved.

clicked(CandlestickSet set)

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

Le gestionnaire de signal correspondant est onClicked.

Remarque : le gestionnaire correspondant est onClicked.

doubleClicked(CandlestickSet set)

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

Le gestionnaire de signal correspondant est onDoubleClicked.

Remarque : le gestionnaire correspondant est onDoubleClicked.

hovered(bool status, CandlestickSet set)

Ce signal est émis lorsqu'un curseur de souris survole la bougie spécifiée par set dans un graphique.

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

Le gestionnaire de signal correspondant est onHovered.

Remarque : le gestionnaire correspondant est onHovered.

pressed(CandlestickSet set)

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

Le gestionnaire de signal correspondant est onPressed.

Remarque : le gestionnaire correspondant est onPressed.

released(CandlestickSet set)

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

Le gestionnaire de signal correspondant est onReleased.

Remarque : le gestionnaire correspondant est onReleased.

Documentation des méthodes

bool append(CandlestickSet 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.

CandlestickSet at(int index)

Renvoie l'élément de chandelier situé à la position spécifiée par ` index`. Renvoie `null` si l'index n'est pas valide.

void clear()

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

bool insert(int index, CandlestickSet 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.

bool remove(CandlestickSet set)

Supprime un élément de chandelier, spécifié par ` set`, de la série.

Renvoie ` true ` si l'élément a été supprimé avec succès, ` false ` dans le cas contraire.

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