Sur cette page

Qt Charts

Le module Qt Charts fournit un ensemble de composants graphiques faciles à utiliser. Il utilise le Qt Graphics View Framework pour intégrer les graphiques aux interfaces utilisateur modernes. Qt Charts peut être utilisé en tant que QWidgets, QGraphicsWidget, ou types QML. Les utilisateurs peuvent facilement créer des graphiques impressionnants en sélectionnant l'un des thèmes.

Remarque : le module Qt Charts est obsolète depuis Qt 6.10. Pour les nouveaux projets, utilisez le module Qt Graphs à la place. Qt Graphs utilise le moteur de rendu natif de chaque plateforme (Metal sur macOS, DirectX sur Windows, OpenGL ou Vulkan sur Linux) pour obtenir un rendu accéléré par le matériel pour les graphiques 2D et 3D. Qt Graphs utilise Qt Quick Shapes pour le rendu des graphes 2D, au lieu du Qt Graphs View Framework obsolète utilisé par le module Qt Charts. Pour migrer du module Qt Charts au module Qt Graphs, voir Qt Graphs Migration à partir de Qt Charts.

L'API QML Qt Charts est un moyen simple et intuitif d'afficher des graphiques dans vos applications QML.

Cet exemple montre comment créer un simple graphique linéaire :

ChartView {
    title: "Line Chart"
    anchors.fill: parent
    antialiasing: true

    LineSeries {
        name: "Line"
        XYPoint { x: 0; y: 0 }
        XYPoint { x: 1.1; y: 2.1 }
        XYPoint { x: 1.9; y: 3.3 }
        XYPoint { x: 2.1; y: 2.1 }
        XYPoint { x: 2.9; y: 4.9 }
        XYPoint { x: 3.4; y: 3.0 }
        XYPoint { x: 4.1; y: 3.3 }
    }
}

Utilisation du module

API QML

Les types QML du module sont disponibles via l'importation QtCharts. Pour utiliser les types, ajoutez l'instruction d'importation suivante à votre fichier .qml :

import QtCharts

Remarque : une instance de QApplication est nécessaire pour les types QML, car le module dépend du Graphics View Framework de Qt pour le rendu. QGuiApplication n'est pas suffisant. Cependant, les projets créés avec l'assistant d'application Qt Quick de Qt Creator sont basés sur le modèle Qt Quick qui utilise QGuiApplication par défaut. Toutes les instances de QGuiApplication dans ces projets doivent être remplacées par QApplication.

API C

L'utilisation de l'API C++ d'un module Qt nécessite l'établissement d'un lien avec la bibliothèque du module, soit directement, soit par l'intermédiaire d'autres dépendances. Plusieurs outils de construction ont un support dédié pour cela, y compris CMake et qmake.

Construction avec CMake

Utilisez la commande find_package() pour localiser le composant de module nécessaire dans le paquetage Qt6:

find_package(Qt6 REQUIRED COMPONENTS Charts)
target_link_libraries(mytarget PRIVATE Qt6::Charts)

Pour plus de détails, voir l'aperçu de la construction avec CMake.

Construction avec qmake

Pour configurer le module afin qu'il soit construit avec qmake, ajoutez le module comme valeur de la variable QT dans le fichier .pro du projet :

QT += charts

Évolution du module

Changes to Qt Charts liste les changements importants dans l'API et les fonctionnalités du module qui ont été effectués pour la série Qt 6 de Qt.

Articles et guides

Exemples

Référence API

Licences

Qt Charts est disponible sous licence commerciale auprès de The Qt Company. En outre, elle est disponible sous la licence publique générale GNU, version 3. Voir Qt Licensing pour plus de détails.

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