En esta página

Qt Charts

El módulo « Qt Charts » ofrece un conjunto de componentes gráficos fáciles de usar. Utiliza el marco Qt Graphics View Framework para integrar gráficos en interfaces de usuario modernas. « Qt Charts » se puede utilizar como QWidgets, « QGraphicsWidget » o tipos QML. Los usuarios pueden crear fácilmente gráficos impresionantes seleccionando uno de los temas.

Nota: El módulo Qt Charts ha quedado obsoleto desde Qt 6.10. Para nuevos proyectos, utiliza en su lugar el Qt Graphs módulo. Qt Graphs utiliza el motor de renderizado nativo de cada plataforma (Metal en macOS, DirectX en Windows, OpenGL o Vulkan en Linux) para lograr un renderizado acelerado por hardware tanto para gráficos 2D como 3D. Qt Graphs utiliza Qt Quick Shapes para el renderizado de gráficos en 2D, en lugar del obsoleto Qt Graphics View Framework que utiliza el módulo « Qt Charts ». Para migrar de « Qt Charts » al módulo « Qt Graphs », consulta Qt Graphs Migración desde Qt Charts.

La API QML de Qt Charts es una forma intuitiva y sencilla de mostrar gráficos en tus aplicaciones QML.

Este ejemplo muestra cómo crear un gráfico de líneas sencillo:

Gráfico lineal con una única línea ascendente que alcanza su punto máximo y luego se estabiliza

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 }
    }
}

Uso del módulo

API de QML

Los tipos QML del módulo están disponibles mediante la importación QtCharts. Para utilizar los tipos, añade la siguiente instrucción de importación a tu archivo .qml:

import QtCharts

Nota: Se requiereuna instancia de ` QApplication ` para los tipos QML, ya que el módulo depende del marco de trabajo de visualización gráfica (Graphics View Framework) de Qt para el renderizado. No basta con ` QGuiApplication `. Sin embargo, los proyectos creados con el asistente de aplicaciones « Qt Quick » de Qt Creator se basan en la plantilla « Qt Quick », que utiliza ` QGuiApplication ` de forma predeterminada. Todas las instancias de ` QGuiApplication ` en dichos proyectos deben sustituirse por ` QApplication`.

API de C++

Para utilizar la API de C++ de un módulo Qt es necesario enlazar con la biblioteca del módulo, ya sea directamente o a través de otras dependencias. Varias herramientas de compilación ofrecen soporte específico para ello, entre ellas CMake y qmake.

Compilación con CMake

Utiliza el comando « find_package() » para localizar el componente del módulo necesario en el paquete « Qt6 »:

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

Para obtener más detalles, consulta la descripción general de «Compilación con CMake ».

Compilación con qmake

Para configurar el módulo para la compilación con qmake, añade el módulo como valor de la variable « QT » en el archivo .pro del proyecto:

QT += charts

Evolución del módulo

La sección«Cambios en Qt Charts » enumera los cambios importantes en la API y la funcionalidad del módulo que se han realizado para la serie Qt 6 de Qt.

Artículos y guías

Ejemplos

Referencia de la API

Las licencias

Qt Charts está disponible bajo licencias comerciales de The Qt Company. Además, está disponible bajo la Licencia Pública General de GNU, versión 3. Consulte Licencias de Qt para obtener más detalles.

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