Back to Qt.io
Contact Us Blog Download Qt
Sur cette page

CandlestickSeries QML Type

Représente une série de données sous forme de chandeliers. Plus d'informations...

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

AbstractSeries

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 les chandeliers individuels. Chaque élément est dessiné 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 dessiné en fonction de sa valeur d'horodatage.

Remarque : les horodatages doivent être uniques au sein d'une CandlestickSeries. Lorsque vous utilisez BarCategoryAxis, seul le premier des chandeliers partageant un horodatage est dessiné. Si le graphique comprend plusieurs instances de CandlestickSeries, 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 ValueAxis ou DateTimeAxis, les éléments de chandelier partageant un horodatage se chevaucheront.

Le document QML suivant montre comment créer un simple graphique en chandelier :

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 montrant un exemple de série de chandeliers avec l'axe des x décrivant les dates.


Voir également CandlestickSet, BarCategoryAxis, DateTimeAxis, et ValueAxis.

Documentation sur les propriétés

axisX : AbstractAxis

L'axe des x utilisé pour la série. Si vous laissez axisX et axisXTop indéfinis, un axe des valeurs est créé pour la série.

Voir également axisXTop et ValueAxis.

axisXTop : AbstractAxis

L'axe des abscisses utilisé pour la série, dessiné au-dessus de la vue du graphique.

Remarque : vous ne pouvez fournir que axisX ou axisXTop, pas les deux.

Voir également axisX.

axisY : AbstractAxis

L'axe des ordonnées utilisé pour la série. Si vous laissez axisY et axisYRight indéfinis, un axe des valeurs est créé pour la série.

Voir également axisYRight et ValueAxis.

axisYRight : AbstractAxis

L'axe des ordonnées utilisé pour la série, dessiné vers la droite sur la vue du graphique.

Remarque : vous ne pouvez fournir que axisY ou axisYRight, pas les deux.

Voir également axisY.

bodyOutlineVisible : bool

La visibilité des contours du corps du chandelier.

bodyWidth : real

Largeur relative de l'élément du chandelier dans son propre emplacement, comprise entre 0,0 et 1,0. Les valeurs en dehors de cette plage sont fixées à 0,0 ou 1,0.

brushFilename : string

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

capsVisible : bool

La visibilité des bouchons.

capsWidth : real

La largeur relative des capuchons à l'intérieur d'un chandelier, dans la plage de 0,0 à 1,0. Les valeurs en dehors de cette plage sont fixées à 0,0 ou 1,0.

count : int [read-only]

Le nombre de chandeliers dans une série.

decreasingColor : color

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 de la brosse, 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.

increasingColor : color

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 de la brosse. 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

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.

minimumColumnWidth : real

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.

Documentation sur les signaux

candlestickSetsAdded(list<CandlestickSet> sets)

Ce signal est émis lorsque les chandeliers spécifiés par sets sont ajoutés à la série.

Le gestionnaire de signal correspondant est onCandlestickSetsAdded.

Note : Le gestionnaire correspondant est onCandlestickSetsAdded.

candlestickSetsRemoved(list<CandlestickSet> sets)

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

Le gestionnaire de signal correspondant est onCandlestickSetsRemoved.

Note : Le gestionnaire correspondant est onCandlestickSetsRemoved.

clicked(CandlestickSet set)

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

Le gestionnaire de signal correspondant est onClicked.

Note : Le gestionnaire correspondant est onClicked.

doubleClicked(CandlestickSet set)

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

Le gestionnaire de signal correspondant est onDoubleClicked.

Note : Le gestionnaire correspondant est onDoubleClicked.

hovered(bool status, CandlestickSet 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.

Le gestionnaire de signal correspondant est onHovered.

Note : Le gestionnaire correspondant est onHovered.

pressed(CandlestickSet 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é.

Le gestionnaire de signal correspondant est onPressed.

Note : Le gestionnaire correspondant est onPressed.

released(CandlestickSet 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.

Le gestionnaire de signal correspondant est onReleased.

Note : Le gestionnaire correspondant est onReleased.

Documentation de la méthode

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

CandlestickSet at(int index)

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

void clear()

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

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

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

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