QChart Class
La classe QChart gère la représentation graphique des séries, des légendes et des axes du graphique. En savoir plus…
| Header: | #include <QChart> |
| Inherits: | QGraphicsWidget |
| Inherited By: | |
| Status: | Deprecated |
Cette classe est obsolète. Nous vous déconseillons fortement de l'utiliser dans du nouveau code.
Types publics
| enum | AnimationOption { NoAnimation, GridAxisAnimations, SeriesAnimations, AllAnimations } |
| flags | AnimationOptions |
| enum | ChartTheme { ChartThemeLight, ChartThemeBlueCerulean, ChartThemeDark, ChartThemeBrownSand, ChartThemeBlueNcs, …, ChartThemeQt } |
| enum | ChartType { ChartTypeUndefined, ChartTypeCartesian, ChartTypePolar } |
Propriétés
|
|
Fonctions publiques
| QChart(QGraphicsItem *parent = nullptr, Qt::WindowFlags wFlags = Qt::WindowFlags()) | |
| virtual | ~QChart() |
| void | addAxis(QAbstractAxis *axis, Qt::Alignment alignment) |
| void | addSeries(QAbstractSeries *series) |
| int | animationDuration() const |
| QEasingCurve | animationEasingCurve() const |
| QChart::AnimationOptions | animationOptions() const |
| QList<QAbstractAxis *> | axes(Qt::Orientations orientation = Qt::Horizontal|Qt::Vertical, QAbstractSeries *series = nullptr) const |
| QBrush | backgroundBrush() const |
| QPen | backgroundPen() const |
| qreal | backgroundRoundness() const |
| QChart::ChartType | chartType() const |
| void | createDefaultAxes() |
| bool | isBackgroundVisible() const |
| bool | isDropShadowEnabled() const |
| bool | isPlotAreaBackgroundVisible() const |
| bool | isZoomed() |
| QLegend * | legend() const |
| QLocale | locale() const |
| bool | localizeNumbers() const |
| QPointF | mapToPosition(const QPointF &value, QAbstractSeries *series = nullptr) |
| QPointF | mapToValue(const QPointF &position, QAbstractSeries *series = nullptr) |
| QMargins | margins() const |
| QRectF | plotArea() const |
| QBrush | plotAreaBackgroundBrush() const |
| QPen | plotAreaBackgroundPen() const |
| void | removeAllSeries() |
| void | removeAxis(QAbstractAxis *axis) |
| void | removeSeries(QAbstractSeries *series) |
| void | scroll(qreal dx, qreal dy) |
| QList<QAbstractSeries *> | series() const |
| void | setAnimationDuration(int msecs) |
| void | setAnimationEasingCurve(const QEasingCurve &curve) |
| void | setAnimationOptions(QChart::AnimationOptions options) |
| void | setBackgroundBrush(const QBrush &brush) |
| void | setBackgroundPen(const QPen &pen) |
| void | setBackgroundRoundness(qreal diameter) |
| void | setBackgroundVisible(bool visible = true) |
| void | setDropShadowEnabled(bool enabled = true) |
| void | setLocale(const QLocale &locale) |
| void | setLocalizeNumbers(bool localize) |
| void | setMargins(const QMargins &margins) |
| void | setPlotArea(const QRectF &rect) |
| void | setPlotAreaBackgroundBrush(const QBrush &brush) |
| void | setPlotAreaBackgroundPen(const QPen &pen) |
| void | setPlotAreaBackgroundVisible(bool visible = true) |
| void | setTheme(QChart::ChartTheme theme) |
| void | setTitle(const QString &title) |
| void | setTitleBrush(const QBrush &brush) |
| void | setTitleFont(const QFont &font) |
| QChart::ChartTheme | theme() const |
| QString | title() const |
| QBrush | titleBrush() const |
| QFont | titleFont() const |
| void | zoom(qreal factor) |
| void | zoomIn() |
| void | zoomIn(const QRectF &rect) |
| void | zoomOut() |
| void | zoomReset() |
Signaux
| void | plotAreaChanged(const QRectF &plotArea) |
Description détaillée
QChart est une classe d'QGraphicsWidget s que vous pouvez afficher dans une QGraphicsScene. Elle gère la représentation graphique de différents types de séries et d'autres objets liés aux graphiques, tels que les légendes et les axes. Pour afficher simplement un graphique dans une mise en page, la classe de commodité QChartView peut être utilisée à la place de QChart. De plus, les séries de lignes, de splines, de zones et de nuages de points peuvent être présentées sous forme de graphiques polaires à l’aide de la classe QPolarChart.
Voir également QChartView et QPolarChart.
Documentation sur les types de membres
enum QChart::AnimationOption
flags QChart::AnimationOptions
Cette énumération décrit les animations activées dans le graphique.
| Constante | Valeur | Description |
|---|---|---|
QChart::NoAnimation | 0x0 | L'animation est désactivée dans le graphique. Il s'agit de la valeur par défaut. |
QChart::GridAxisAnimations | 0x1 | L'animation des axes de la grille est activée dans le graphique. |
QChart::SeriesAnimations | 0x2 | L'animation des séries est activée dans le graphique. |
QChart::AllAnimations | 0x3 | Tous les types d'animation sont activés dans le graphique. |
Le type AnimationOptions est un typedef pour QFlags<AnimationOption>. Il stocke une combinaison OR de valeurs AnimationOption.
enum QChart::ChartTheme
Cette énumération décrit le thème utilisé par le graphique.
Un thème est un ensemble intégré de paramètres liés au style de l'interface utilisateur, appliqués à tous les éléments visuels d'un graphique, tels que les couleurs, les stylos, les pinceaux et les polices des séries, ainsi que les axes, le titre et la légende. La galerie « Graphiques avec widgets » illustre comment utiliser les thèmes.
Remarque : la modification du thème écrasera toutes les personnalisations précédemment appliquées aux séries.
| Constante | Valeur | Description |
|---|---|---|
QChart::ChartThemeLight | 0 | Le thème clair, qui est le thème par défaut. |
QChart::ChartThemeBlueCerulean | 1 | Le thème bleu céruléen. |
QChart::ChartThemeDark | 2 | Le thème sombre. |
QChart::ChartThemeBrownSand | 3 | Le thème marron sable. |
QChart::ChartThemeBlueNcs | 4 | Le thème bleu du système de couleurs naturelles (NCS). |
QChart::ChartThemeHighContrast | 5 | Le thème à contraste élevé. |
QChart::ChartThemeBlueIcy | 6 | Le thème bleu glacier. |
QChart::ChartThemeQt | 7 | Le thème Qt. |
enum QChart::ChartType
Cette énumération décrit le type de graphique.
| Constante | Valeur | Description |
|---|---|---|
QChart::ChartTypeUndefined | 0 | Le type de graphique n'est pas défini. |
QChart::ChartTypeCartesian | 1 | Un graphique cartésien. |
QChart::ChartTypePolar | 2 | Un graphique polaire. |
Documentation sur les propriétés
animationDuration : int
Cette propriété définit la durée de l'animation du graphique.
Fonctions d'accès :
| int | animationDuration() const |
| void | setAnimationDuration(int msecs) |
animationEasingCurve : QEasingCurve
Cette propriété définit la courbe d'accélération de l'animation du graphique.
Fonctions d'accès :
| QEasingCurve | animationEasingCurve() const |
| void | setAnimationEasingCurve(const QEasingCurve &curve) |
animationOptions : QChart::AnimationOptions
Cette propriété définit les options d'animation du graphique.
Les animations sont activées ou désactivées en fonction de ce paramètre.
Fonctions d'accès :
| QChart::AnimationOptions | animationOptions() const |
| void | setAnimationOptions(QChart::AnimationOptions options) |
backgroundRoundness : qreal
Cette propriété définit le diamètre du cercle d'arrondi au niveau des coins de l'arrière-plan du graphique.
Fonctions d'accès :
| qreal | backgroundRoundness() const |
| void | setBackgroundRoundness(qreal diameter) |
backgroundVisible : bool
Cette propriété détermine si l'arrière-plan du graphique est visible.
Fonctions d'accès :
| bool | isBackgroundVisible() const |
| void | setBackgroundVisible(bool visible = true) |
Voir également setBackgroundBrush(), setBackgroundPen() et plotAreaBackgroundVisible.
[read-only] chartType : QChart::ChartType
Cette propriété s'applique aussi bien aux graphiques cartésiens qu'aux graphiques polaires.
Cette propriété est définie en interne et est en lecture seule.
Fonctions d'accès :
| QChart::ChartType | chartType() const |
Voir également QPolarChart.
dropShadowEnabled : bool
Cette propriété détermine si l'effet d'ombre portée en arrière-plan est activé.
Si la valeur est définie sur « true », l'effet d'ombre portée en arrière-plan est activé. Si la valeur est définie sur « false », il est désactivé.
Remarque : l'effet d'ombre portée dépend du thème ; ce paramètre peut donc changer si le thème est modifié.
Fonctions d'accès :
| bool | isDropShadowEnabled() const |
| void | setDropShadowEnabled(bool enabled = true) |
locale : QLocale
Cette propriété définit les paramètres régionaux utilisés pour le formatage des différentes étiquettes du graphique.
Les étiquettes ne sont localisées que lorsque la propriété « localizeNumbers » est définie sur « true », à l'exception des étiquettes QDateTimeAxis, qui utilisent toujours la valeur « QLocale » définie par cette propriété.
La valeur par défaut correspond aux paramètres régionaux de l'application au moment de la création du graphique.
Fonctions d’accès :
| QLocale | locale() const |
| void | setLocale(const QLocale &locale) |
Voir également localizeNumbers.
localizeNumbers : bool
Cette propriété s'applique que les nombres soient localisés ou non.
Lorsque la propriété « true » est définie, tous les nombres générés apparaissant dans les différentes séries et étiquettes d’axe seront localisés à l’aide de l’ QLocale, défini par la propriété « locale ». Lorsque la propriété « false » est définie, la locale C est toujours utilisée. La valeur par défaut est « false ».
Remarque : cette propriété n’affecte pas les étiquettes QDateTimeAxis, qui utilisent toujours la valeur « QLocale » définie par la propriété locale.
Fonctions d'accès :
| bool | localizeNumbers() const |
| void | setLocalizeNumbers(bool localize) |
Voir également locale.
margins : QMargins
Cette propriété définit les marges minimales autorisées entre le bord du rectangle du graphique et la zone de tracé.
Ces marges servent à tracer le titre, les axes et la légende.
Fonctions d'accès :
| QMargins | margins() const |
| void | setMargins(const QMargins &margins) |
plotArea : QRectF
Cette propriété définit le rectangle dans lequel le graphique est tracé.
La zone de tracé n'inclut pas la zone définie par les marges. Par défaut, sa taille s'adapte automatiquement si elle se trouve à l'intérieur d'un QChartView. Si une taille explicite est définie pour la zone de tracé, celle-ci sera respectée ; pour revenir au comportement par défaut, il suffit d'appeler la méthode setPlotArea(QRectF());.
Fonctions d'accès :
| QRectF | plotArea() const |
| void | setPlotArea(const QRectF &rect) |
Signal de notification :
| void | plotAreaChanged(const QRectF &plotArea) |
plotAreaBackgroundVisible : bool
Cette propriété détermine si l'arrière-plan de la zone de tracé du graphique est visible.
Remarque : par défaut, l'arrière-plan de la zone de tracé est invisible et celle-ci utilise l'arrière-plan général du graphique.
Fonctions d'accès :
| bool | isPlotAreaBackgroundVisible() const |
| void | setPlotAreaBackgroundVisible(bool visible = true) |
Voir également setPlotAreaBackgroundBrush(), setPlotAreaBackgroundPen() et backgroundVisible.
theme : QChart::ChartTheme
Cette propriété définit le thème utilisé pour le graphique.
Fonctions d'accès :
| QChart::ChartTheme | theme() const |
| void | setTheme(QChart::ChartTheme theme) |
title : QString
Cette propriété contient le titre du graphique.
Le titre s'affiche sous forme d'en-tête au-dessus du graphique. Les titres de graphique prennent en charge la mise en forme HTML.
Fonctions d'accès :
| QString | title() const |
| void | setTitle(const QString &title) |
Documentation sur les fonctions des membres
[explicit] QChart::QChart(QGraphicsItem *parent = nullptr, Qt::WindowFlags wFlags = Qt::WindowFlags())
Crée un objet graphique qui est un enfant de parent. Les propriétés spécifiées par wFlags sont transmises au constructeur QGraphicsWidget.
[virtual noexcept] QChart::~QChart()
Supprime l'objet graphique et ses éléments enfants, tels que les objets de série et d'axe qui y ont été ajoutés.
void QChart::addAxis(QAbstractAxis *axis, Qt::Alignment alignment)
Ajoute l'axe axis au graphique, aligné selon les spécifications de alignment. Le graphique devient propriétaire de l'axe.
Voir également removeAxis(), createDefaultAxes() et QAbstractSeries::attachAxis().
void QChart::addSeries(QAbstractSeries *series)
Ajoute la série series au graphique et en prend la propriété.
Remarque : par défaut,une série nouvellement ajoutée n'est rattachée à aucun axe, pas même à ceux qui auraient pu être créés pour le graphique à l'aide de la fonction createDefaultAxes() avant que la série ne soit ajoutée au graphique. Si aucun axe n’est associé à la série nouvellement ajoutée avant l’affichage du graphique, celle-ci sera tracée comme si elle disposait d’axes dont les plages s’adaptent parfaitement à la série dans la zone de tracé du graphique. Cela peut prêter à confusion si le même graphique affiche également d’autres séries auxquelles des axes ont été correctement associés ; veillez donc toujours à appeler la fonction ` createDefaultAxes()` après l’ajout d’une série ou à associer explicitement des axes à cette série.
Voir également removeSeries(), removeAllSeries(), createDefaultAxes() et QAbstractSeries::attachAxis().
QList<QAbstractAxis *> QChart::axes(Qt::Orientations orientation = Qt::Horizontal|Qt::Vertical, QAbstractSeries *series = nullptr) const
Renvoie les axes associés à la série series avec l'orientation spécifiée par orientation. Si aucune série n'est spécifiée, tous les axes ajoutés au graphique avec l'orientation spécifiée sont renvoyés.
Voir également addAxis() et createDefaultAxes().
QBrush QChart::backgroundBrush() const
Récupère le pinceau utilisé pour peindre l'arrière-plan de la zone du graphique.
Voir également setBackgroundBrush().
QPen QChart::backgroundPen() const
Récupère le stylo utilisé pour peindre l'arrière-plan de la zone du graphique.
Voir également setBackgroundPen().
void QChart::createDefaultAxes()
Crée des axes pour le graphique en fonction des séries déjà ajoutées à celui-ci. Tous les axes précédemment ajoutés au graphique seront supprimés.
Remarque : cette fonction doit être appelée une fois que toutes les séries ont été ajoutées au graphique. Les axes créés par cette fonction ne seront PAS automatiquement associés aux séries ajoutées au graphique après l'appel de cette fonction. Une série à laquelle aucun axe n'est associé s'étendra par défaut sur toute la zone de tracé du graphique, ce qui peut prêter à confusion si d'autres séries dotées d'axes correctement associés sont également présentes.
| Type de série | Axe horizontal (X) | Axe vertical (Y) |
|---|---|---|
| QXYSeries | QValueAxis | Axe de valeur Q |
| Série QBar | Axe de catégorie des barres Q | Axe de valeur Q |
| QPieSeries | Aucun | Aucun |
Si plusieurs séries dérivées de QXYSeries sont ajoutées au graphique et qu'aucune série d'un autre type n'a été ajoutée, une seule paire d'axes est créée. Si plusieurs séries de types différents sont ajoutées au graphique, chaque série dispose alors de sa propre paire d'axes.
Les axes spécifiques à la série peuvent être obtenus ultérieurement à partir du graphique en passant la série en paramètre à l'appel de la fonction axes(). QPieSeries ne crée aucun axe.
Voir également axes() et QAbstractSeries::attachAxis().
bool QChart::isZoomed()
Renvoie « true » si une série quelconque présente un domaine zoomé.
QLegend *QChart::legend() const
Renvoie l'objet « légende » du graphique. La propriété reste celle du graphique.
QPointF QChart::mapToPosition(const QPointF &value, QAbstractSeries *series = nullptr)
Renvoie la position sur le graphique qui correspond à la valeur value dans la série spécifiée par series.
QPointF QChart::mapToValue(const QPointF &position, QAbstractSeries *series = nullptr)
Renvoie la valeur de la série spécifiée par series à la position indiquée par position dans un graphique.
QBrush QChart::plotAreaBackgroundBrush() const
Renvoie le pinceau utilisé pour remplir l'arrière-plan de la zone de tracé du graphique.
Voir également plotArea(), plotAreaBackgroundVisible, plotAreaBackgroundPen() et setPlotAreaBackgroundBrush().
QPen QChart::plotAreaBackgroundPen() const
Renvoie le stylo utilisé pour dessiner l'arrière-plan de la zone de tracé du graphique.
Voir également plotArea(), plotAreaBackgroundVisible, plotAreaBackgroundBrush() et setPlotAreaBackgroundPen().
void QChart::removeAllSeries()
Supprime tous les objets de série qui ont été ajoutés au graphique.
Voir également addSeries() et removeSeries().
void QChart::removeAxis(QAbstractAxis *axis)
Supprime l'axis d'axe du graphique. Le graphique libère la propriété de l'objet axis spécifié.
Voir également addAxis(), createDefaultAxes() et QAbstractSeries::detachAxis().
void QChart::removeSeries(QAbstractSeries *series)
Supprime la série series du graphique. Le graphique libère la référence à l'objet series spécifié.
Voir également addSeries() et removeAllSeries().
void QChart::scroll(qreal dx, qreal dy)
Fait défiler la zone visible du graphique de la distance spécifiée par dx et dy.
Pour les graphiques polaires, dx indique l'angle le long de l'axe angulaire au lieu de la distance.
QList<QAbstractSeries *> QChart::series() const
Renvoie toutes les séries ajoutées au graphique.
Voir également addSeries(), removeSeries() et removeAllSeries().
void QChart::setBackgroundBrush(const QBrush &brush)
Définit le pinceau utilisé pour peindre l'arrière-plan de la zone du graphique sur « brush ».
Voir également backgroundBrush().
void QChart::setBackgroundPen(const QPen &pen)
Définit le stylo utilisé pour colorer l'arrière-plan de la zone du graphique sur pen.
Voir également backgroundPen().
void QChart::setPlotAreaBackgroundBrush(const QBrush &brush)
Définit le pinceau utilisé pour remplir l'arrière-plan de la zone de tracé du graphique sur « brush ».
Voir également plotArea(), plotAreaBackgroundVisible, setPlotAreaBackgroundPen() et plotAreaBackgroundBrush().
void QChart::setPlotAreaBackgroundPen(const QPen &pen)
Définit le stylo utilisé pour dessiner l'arrière-plan de la zone de tracé du graphique sur « pen ».
Voir également plotArea(), plotAreaBackgroundVisible, setPlotAreaBackgroundBrush() et plotAreaBackgroundPen().
void QChart::setTitleBrush(const QBrush &brush)
Définit le pinceau utilisé pour dessiner le texte du titre sur « brush ».
Voir aussi titleBrush().
void QChart::setTitleFont(const QFont &font)
Définit la police utilisée pour l'affichage du titre du graphique sur « font ».
Voir aussi titleFont().
QBrush QChart::titleBrush() const
Renvoie le pinceau utilisé pour dessiner le texte du titre.
Voir aussi setTitleBrush().
QFont QChart::titleFont() const
Récupère la police utilisée pour l'affichage du titre du graphique.
Voir également setTitleFont().
void QChart::zoom(qreal factor)
Effectue un zoom avant sur la vue selon le facteur personnalisé factor.
Un facteur supérieur à 1,0 effectue un zoom avant sur la vue, tandis qu'un facteur compris entre 0,0 et 1,0 effectue un zoom arrière.
void QChart::zoomIn()
Agrandit la vue d'un facteur deux.
void QChart::zoomIn(const QRectF &rect)
Effectue un zoom avant sur la vue jusqu'au niveau maximal auquel le rectangle rect reste entièrement visible.
Remarque : l'application d'un zoom peut modifier les propriétés des axes associés, par exemple QAbstractAxis::min et QAbstractAxis::max.
Remarque : cette fonctionnalité n'est pas prise en charge pour les graphiques polaires.
void QChart::zoomOut()
Réduit l'affichage d'un facteur deux.
Remarque : cette opération n'aura aucun effet si le résultat devait contenir une plage d'axe logarithmique non valide.
void QChart::zoomReset()
Réinitialise les domaines de la série à leur état initial, avant l'appel de toute méthode de zoom.
Remarque : cela réinitialise également les paramètres de défilement et les plages d'axes explicites définis entre la première opération de zoom et l'appel de cette méthode. Si aucune opération de zoom n'a été effectuée, cette méthode n'a aucun effet.
© 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.
