En esta página

Qt Charts C++ Classes

Clases C++ para la API Qt Charts. Más...

Este módulo está obsoleto desde la versión 6.10. Desaconsejamos encarecidamente su uso en código nuevo.

Clases

QAbstractAxis

Clase base utilizada para clases especializadas de ejes

QAbstractBarSeries

Clase padre abstracta para todas las clases de series de barras

QAbstractSeries

Clase base para todas las series de Qt Charts

QAreaLegendMarker

Marcador de leyenda para una serie de área

QAreaSeries

Presenta datos en gráficos de área

QBarCategoryAxis

Añade categorías a los ejes de un gráfico

QBarLegendMarker

Marcador de leyenda para una serie de barras

QBarSeries

Presenta una serie de datos como barras verticales agrupadas por categoría

QBarSet

Representa una serie de barras en un gráfico de barras

QBoxPlotLegendMarker

Marcador de leyenda para una serie de gráficos de cajas

QBoxPlotSeries

Presenta los datos en gráficos de cajas y bigotes

QBoxSet

Representa un elemento en un gráfico de cajas y bigotes

QCandlestickLegendMarker

Marcador de leyenda para una serie de velas

QCandlestickModelMapper

Clase de modelo abstracto para series de velas

QCandlestickSeries

Presenta los datos en forma de velas

QCandlestickSet

Representa un único elemento en un gráfico de velas

QCategoryAxis

Coloca rangos con nombre en el eje

QChart

Gestiona la representación gráfica de las series, leyendas y ejes del gráfico

QChartView

Widget independiente que puede mostrar gráficos

QColorAxis

Muestra una escala de colores como uno de los ejes del gráfico

QDateTimeAxis

Añade fechas y horas a los ejes de un gráfico

QHBarModelMapper

Mapeador de modelos horizontales para series de barras

QHBoxPlotModelMapper

Model mapper horizontal para series de cajas

QHCandlestickModelMapper

Model mapper horizontal para series de velas

QHPieModelMapper

Modelo horizontal para series circulares

QHXYModelMapper

Model mapper horizontal para series de líneas, splines y dispersión

QHorizontalBarSeries

Presenta una serie de datos como barras horizontales agrupadas por categoría

QHorizontalPercentBarSeries

Presenta una serie de datos categorizados como un porcentaje de cada categoría

QHorizontalStackedBarSeries

Presenta una serie de datos como barras apiladas horizontalmente, con una barra por categoría

QLegend

Muestra la leyenda de un gráfico

QLegendMarker

Objeto abstracto que puede utilizarse para acceder a los marcadores de una leyenda

QLineSeries

Presenta los datos en gráficos de líneas

QLogValueAxis

Añade una escala logarítmica al eje de un gráfico

QPercentBarSeries

Presenta una serie de datos categorizados como porcentaje de cada categoría

QPieLegendMarker

Marcador de leyenda para una serie circular

QPieSeries

Presenta datos en gráficos circulares

QPieSlice

Representa una única porción de una serie circular

QPolarChart

Presentación de datos en gráficos polares

QScatterSeries

Presentación de datos en gráficos de dispersión

QSplineSeries

Presentación de datos en gráficos de splines

QStackedBarSeries

Presenta una serie de datos como barras apiladas verticalmente, con una barra por categoría

QVBarModelMapper

Mapeador de modelos verticales para series de barras

QVBoxPlotModelMapper

Vertical model mapper para series de gráficos de caja

QVCandlestickModelMapper

Vertical model mapper para series de velas

QVPieModelMapper

Modelo vertical para series circulares

QVXYModelMapper

Mapeador de modelos verticales para series de líneas, splines y dispersión

QValueAxis

Añade valores a los ejes de un gráfico

QXYLegendMarker

Marcador de leyenda para una serie lineal, spline o de dispersión

QXYSeries

Clase base para series de líneas, splines y dispersión

Descripción detallada

Utilice QtGraphs en su lugar.

La API de Qt Charts está construida sobre Qt Graphics View Framework. Los gráficos pueden mostrarse como QGraphicsWidget utilizando la clase QChart. Sin embargo, también existe la clase de conveniencia QChartView, que se basa en QWidget. Esto nos permite usar rápidamente Qt Charts como un widget Qt normal.

Nota: El módulo Qt Charts está obsoleto desde Qt 6.10. Para nuevos proyectos, usa el módulo Qt GraphsQt Graphs utiliza el backend de renderizado nativo de cada plataforma (Metal en macOS, DirectX en Windows, OpenGL o Vulkan en Linux) para conseguir un renderizado acelerado por hardware tanto para gráficos 2D como 3D. Qt Graphs utiliza Qt Quick Shapes para el renderizado de gráficos 2D, en lugar del anticuado Qt Graphics View Framework utilizado por el módulo Qt Charts. Para migrar de Qt Charts al módulo Qt Graphs, consulte Qt Graphs Migración desde Qt Charts.

El uso de la API C++ de un módulo Qt requiere la vinculación con la biblioteca del módulo, ya sea directamente o a través de otras dependencias. Varias herramientas de compilación tienen soporte dedicado para esto, incluyendo CMake y qmake.

Nota: Los proyectos creados con Qt Creator's Qt Quick Asistente de aplicación se basan en la plantilla Qt Quick 2 que utiliza QGuiApplication por defecto. Todas las instancias de QGuiApplication en el proyecto deben ser reemplazadas por QApplication ya que el módulo depende del Graphics View Framework de Qt para su renderizado.

Para utilizar el módulo con CMake, utilice el comando find_package() para localizar los componentes necesarios del módulo en el paquete Qt6:

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

Para utilizar el módulo para construir con qmake, añada el módulo como valor de la variable QT en el archivo .pro del proyecto:

QT += charts

Cada tipo de gráfico está representado por la clase derivada QAbstractSeries. Para crear gráficos, los usuarios deben utilizar una instancia de la clase de series relacionada y añadirla a una instancia de QChart.

QLineSeries* series = new QLineSeries();
series->append(0, 6);
series->append(2, 4);
...
chartView->chart()->addSeries(series);
chartView->chart()->createDefaultAxes();

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