QChart Class
La classe QChart gère la représentation graphique des séries, des légendes et des axes du graphique. Plus d'informations...
| Header: | #include <QChart> |
| Inherits: | QGraphicsWidget |
| Inherited By: |
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 un QGraphicsWidget que vous pouvez afficher dans un QGraphicsScene. Il gère la représentation graphique de différents types de séries et d'autres objets liés au graphique comme la légende et les axes. Pour afficher simplement un graphique dans une présentation, la classe de commodité QChartView peut être utilisée à la place de QChart. En outre, les séries de lignes, de splines, d'aires et de nuages de points peuvent être présentées sous forme de graphiques polaires en utilisant la classe QPolarChart.
Voir également QChartView et QPolarChart.
Documentation des 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 OU de valeurs AnimationOption.
enum QChart::ChartTheme
Cette énumération décrit le thème utilisé par le graphique.
Un thème est une collection intégrée de paramètres liés au style de l'interface utilisateur et appliqués à tous les éléments visuels d'un graphique, tels que les couleurs, les stylos, les pinceaux et les polices de caractères des séries, ainsi que les axes, le titre et la légende. La galerie Graphiques avec Widgets illustre la manière d'utiliser les thèmes.
Remarque : la modification du thème écrase toutes les personnalisations précédemment appliquées à la série.
| Constante | Valeur | Description du thème |
|---|---|---|
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 foncé. |
QChart::ChartThemeBrownSand | 3 | Le thème brun sable. |
QChart::ChartThemeBlueNcs | 4 | Le thème bleu du système de couleurs naturelles (NCS). |
QChart::ChartThemeHighContrast | 5 | Le thème à fort contraste. |
QChart::ChartThemeBlueIcy | 6 | Le thème bleu glacé. |
QChart::ChartThemeQt | 7 | Le thème Qt. |
enum QChart::ChartType
Cette énumération décrit le type de graphique.
| Constante | Valeur | Description du type de graphique |
|---|---|---|
QChart::ChartTypeUndefined | 0 | Le type de graphique n'est pas défini. |
QChart::ChartTypeCartesian | 1 | Une carte cartésienne. |
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é contient la courbe d'assouplissement de l'animation pour le graphique.
Fonctions d'accès :
| QEasingCurve | animationEasingCurve() const |
| void | setAnimationEasingCurve(const QEasingCurve &curve) |
animationOptions : QChart::AnimationOptions
Cette propriété contient les options d'animation pour le 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 aux coins de l'arrière-plan du graphique.
Fonctions d'accès :
| qreal | backgroundRoundness() const |
| void | setBackgroundRoundness(qreal diameter) |
backgroundVisible : bool
Cette propriété indique si l'arrière-plan du graphique est visible.
Fonctions d'accès :
| bool | isBackgroundVisible() const |
| void | setBackgroundVisible(bool visible = true) |
Voir aussi setBackgroundBrush(), setBackgroundPen() et plotAreaBackgroundVisible.
[read-only] chartType : QChart::ChartType
Cette propriété indique si la carte est cartésienne ou polaire.
Cette propriété est définie en interne et n'est accessible qu'en lecture.
Fonctions d'accès :
| QChart::ChartType | chartType() const |
Voir aussi QPolarChart.
dropShadowEnabled : bool
Cette propriété indique si l'effet d'ombre portée de l'arrière-plan est activé.
Si la valeur est true, l'effet d'ombre portée de l'arrière-plan est activé. S'il vaut false, il est désactivé.
Remarque : L'effet d'ombre portée dépend du thème et le 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é indique la locale utilisée pour formater les différentes étiquettes des graphiques.
Les étiquettes ne sont localisées que si localizeNumbers est true, à l'exception des étiquettes QDateTimeAxis, qui utilisent toujours la locale QLocale définie avec cette propriété.
La valeur par défaut est la locale par défaut de l'application au moment de la construction du graphique.
Fonctions d'accès :
| QLocale | locale() const |
| void | setLocale(const QLocale &locale) |
Voir également localizeNumbers.
localizeNumbers : bool
Cette propriété indique si les nombres sont localisés.
Avec true, tous les nombres générés apparaissant dans les différentes séries et étiquettes d'axes seront localisés en utilisant la locale QLocale définie avec la propriété locale. Avec false, 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 locale QLocale définie avec 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é.
Les marges sont utilisées pour dessiner 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 à l'intérieur duquel le graphique est dessiné.
La zone de tracé n'inclut pas la zone définie par les marges. Par défaut, le rectangle est redimensionné s'il se trouve à l'intérieur d'un QChartView. Si une taille explicite est définie pour la zone de tracé, celle-ci est respectée. Pour revenir au comportement par défaut, l'appel à setPlotArea(QRectF()); permet d'atteindre cet objectif.
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é indique si l'arrière-plan de la zone de tracé est visible.
Remarque : Par défaut, l'arrière-plan de la zone de tracé est invisible et la zone de tracé 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é contient 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 est affiché en haut du graphique. Les titres des graphiques prennent en charge le formatage HTML.
Fonctions d'accès :
| QString | title() const |
| void | setTitle(const QString &title) |
Documentation des fonctions membres
[explicit] QChart::QChart(QGraphicsItem *parent = nullptr, Qt::WindowFlags wFlags = Qt::WindowFlags())
Construit 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 enfants, tels que les objets de série et d'axe qui lui ont été ajoutés.
void QChart::addAxis(QAbstractAxis *axis, Qt::Alignment alignment)
Ajoute l'axe axis au graphique aligné comme spécifié par alignment. Le graphique devient propriétaire de l'axe.
Voir aussi removeAxis(), createDefaultAxes() et QAbstractSeries::attachAxis().
void QChart::addSeries(QAbstractSeries *series)
Ajoute la série series au graphique et en prend possession.
Remarque : Une série nouvellement ajoutée n'est attachée à aucun axe par défaut, pas même ceux qui auraient pu être créés pour le graphique à l'aide de createDefaultAxes() avant que la série ne soit ajoutée au graphique. Si aucun axe n'est attaché à la série nouvellement ajoutée avant que le graphique ne soit affiché, la série sera dessinée comme si elle avait des axes avec des plages qui s'adaptent exactement à la zone de tracé du graphique. Cela peut prêter à confusion si le même graphique affiche également d'autres séries dont les axes sont correctement attachés. Veillez donc toujours à appeler createDefaultAxes() après l'ajout d'une série ou à attacher explicitement des axes à la 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 attaché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 aussi addAxis() et createDefaultAxes().
QBrush QChart::backgroundBrush() const
Obtient la brosse utilisée pour peindre l'arrière-plan de la zone graphique.
Voir également setBackgroundBrush().
QPen QChart::backgroundPen() const
Obtient le stylo utilisé pour peindre l'arrière-plan de la zone graphique.
Voir également setBackgroundPen().
void QChart::createDefaultAxes()
Crée des axes pour le graphique sur la base des séries qui ont déjà été ajoutées au graphique. Tous les axes précédemment ajoutés au graphique seront supprimés.
Remarque : cette fonction doit être appelée après que toutes les séries ont été ajoutées au graphique. Les axes créés par cette fonction ne seront PAS automatiquement attachés aux séries ajoutées au graphique après l'appel de cette fonction. Une série sans axes attachés sera par défaut mise à l'échelle pour utiliser toute la surface du graphique, ce qui peut être déroutant si d'autres séries avec des axes correctement attachés sont également présentes.
| Type de série | Axe horizontal (X) | Axe vertical (Y) |
|---|---|---|
| QXYSeries | QValueAxis | QValueAxis |
| QBarSeries | QBarCategoryAxis | QValueAxis |
| 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 reçoit sa propre paire d'axes.
Les axes spécifiques à la série peuvent être obtenus ultérieurement à partir du graphique en fournissant la série comme paramètre de l'appel de la fonction axes(). QPieSeries ne crée pas d'axes.
Voir également axes() et QAbstractSeries::attachAxis().
bool QChart::isZoomed()
Renvoie true si une série a un domaine zoomé.
QLegend *QChart::legend() const
Renvoie l'objet légende du graphique. La propriété reste avec le 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 spécifiée par position dans un graphique.
QBrush QChart::plotAreaBackgroundBrush() const
Renvoie la brosse utilisée pour remplir l'arrière-plan de la zone de tracé du graphique.
Voir aussi 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 aussi plotArea(), plotAreaBackgroundVisible, plotAreaBackgroundBrush(), et setPlotAreaBackgroundPen().
void QChart::removeAllSeries()
Retire et 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'axe axis 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 propriété de l'objet series spécifié.
Voir également addSeries() et removeAllSeries().
void QChart::scroll(qreal dx, qreal dy)
Fait défiler la zone visible de la carte sur 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 aussi addSeries(), removeSeries() et removeAllSeries().
void QChart::setBackgroundBrush(const QBrush &brush)
Définit la brosse utilisée pour peindre l'arrière-plan de la zone graphique à brush.
Voir aussi backgroundBrush().
void QChart::setBackgroundPen(const QPen &pen)
Définit le stylo utilisé pour peindre l'arrière-plan de la zone graphique sur pen.
Voir également backgroundPen().
void QChart::setPlotAreaBackgroundBrush(const QBrush &brush)
Définit la brosse utilisée pour remplir l'arrière-plan de la zone de tracé du graphique à 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 la brosse utilisée pour dessiner le texte du titre à brush.
Voir aussi titleBrush().
void QChart::setTitleFont(const QFont &font)
Définit la police utilisée pour dessiner le titre du graphique à font.
Voir également titleFont().
QBrush QChart::titleBrush() const
Renvoie la brosse utilisée pour dessiner le texte du titre.
Voir également setTitleBrush().
QFont QChart::titleFont() const
Obtient la police utilisée pour dessiner le titre du graphique.
Voir également setTitleFont().
void QChart::zoom(qreal factor)
Effectue un zoom sur la vue selon le facteur personnalisé factor.
Un facteur supérieur à 1,0 permet de zoomer dans la vue et un facteur compris entre 0,0 et 1,0 permet de zoomer hors de la vue.
void QChart::zoomIn()
Agrandit la vue d'un facteur de deux.
void QChart::zoomIn(const QRectF &rect)
Permet d'effectuer un zoom sur la vue jusqu'à un niveau maximal auquel le rectangle rect est encore entièrement visible.
Note : L'application d'un zoom peut modifier les propriétés des axes attachés, par exemple QAbstractAxis::min et QAbstractAxis::max.
Remarque : cette fonction n'est pas prise en charge pour les graphiques polaires.
void QChart::zoomOut()
Agrandit la vue d'un facteur de deux.
Remarque : cette opération n'aura aucun effet si le résultat contient une plage d'axes logarithmiques non valide.
void QChart::zoomReset()
Réinitialise les domaines de la série à ce qu'ils étaient avant l'appel d'une méthode de zoom.
Remarque : cette méthode réinitialise également les paramètres de défilement et de plage d'axes explicites spécifiés 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 ne fait rien.
© 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.
