Qt Charts Descripción general
Qt Charts permite crear interfaces de usuario elegantes, interactivas y centradas en los datos. Qt Charts utiliza el Graphics View Framework para facilitar la integración. Los componentes de gráficos se pueden utilizar como objetos de tipo « QWidget » o « QGraphicsWidget », o como tipos QML.

Nota: El módulo Qt Charts ha quedado obsoleto desde Qt 6.10. Para proyectos nuevos, 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 2D, en lugar del obsoleto Qt Graphics View Framework utilizado por el módulo Qt Charts. Para migrar de Qt Charts al módulo Qt Graphs, consulta Qt Graphs Migración desde Qt Charts.
La clase `QChart` gestiona la representación gráfica de diferentes tipos de series y otros objetos relacionados con los gráficos, como la leyenda y los ejes. `QChart` es un ` QGraphicsWidget ` que puede mostrarse en un ` QGraphicsScene`. Una solución más sencilla consiste en mostrar un gráfico en un diseño utilizando la clase de conveniencia `QChartView` en lugar de `QChart`. En QML, los gráficos se muestran utilizando el tipo ChartView.
Algunos componentes de gráficos también pueden presentarse como gráficos polares utilizando la clase QPolarChart, que es una especialización de la clase QChart, o el tipo QML PolarChartView, que es una especialización del tipo ChartView.
El aspecto de los gráficos se puede personalizar utilizando temas, modificando colores y propiedades, ocultando componentes del gráfico o animando los gráficos.
Los mapeadores de modelos permiten utilizar un modelo de datos derivado de la clase « QAbstractItemModel » como fuente de datos para un gráfico. Los mapeadores de modelos pueden ser horizontales o verticales.
Tipos de gráficos
El módulo « Qt Charts » ofrece los siguientes tipos de gráficos:
- Gráficos de líneas y splines
- Gráficos de área y de dispersión
- Gráficos de barras
- Gráficos circulares
- Gráficos de caja y bigotes
- Gráficos de velas
- Gráficos polares
Cada tipo de gráfico está representado por una clase derivada de QAbstractSeries o un tipo derivado de AbstractSeries en QML. Los gráficos se crean utilizando una instancia de una clase de serie y añadiéndola a una instancia de QChart o ChartView.
Por ejemplo:
QLineSeries* series = new QLineSeries();
series->add(0, 6);
series->add(2, 4);
...
chartView->chart()->addSeries(series);
chartView->chart()->createDefaultAxes();O, en QML:
ChartView {
id: chart
title: "Top-5 car brand shares in Finland"
anchors.fill: parent
legend.alignment: Qt.AlignBottom
antialiasing: true
property variant othersSlice: 0
PieSeries {
id: pieSeries
PieSlice { label: "Volkswagen"; value: 13.5 }
PieSlice { label: "Toyota"; value: 10.9 }
PieSlice { label: "Ford"; value: 8.6 }
PieSlice { label: "Skoda"; value: 8.2 }
PieSlice { label: "Volvo"; value: 6.8 }
}
Component.onCompleted: {
// You can also manipulate slices dynamically, like append a slice or set a slice exploded
othersSlice = pieSeries.append("Others", 52.0);
pieSeries.find("Volkswagen").exploded = true;
}
}
import QtQuickSe pueden combinar diferentes tipos de series en un mismo gráfico.
Gráficos de líneas y splines
Los gráficos de líneas y splines presentan los datos como una serie de puntos de datos conectados por líneas. En un gráfico de líneas, los puntos de datos están conectados por líneas rectas, mientras que en un gráfico de splines están conectados por una spline. La spline se dibuja utilizando ` QPainterPath`.

Un gráfico de líneas se implementa utilizando la clase QLineSeries o el tipo QML LineSeries.
Un gráfico de spline se implementa utilizando la clase QSplineSeries, que hereda de QLineSeries, o el tipo SplineSeries, que hereda de LineSeries.
Para obtener más información, consulta Creación de gráficos de líneas y Creación de gráficos de splines. Para ver un ejemplo de cómo combinar un gráfico de líneas con un gráfico de barras y utilizar un eje común para ambos, consulta Combinación de gráficos de líneas y de barras.
Gráficos de área y de dispersión
Los gráficos de área presentan los datos como un área delimitada por dos líneas, mientras que los gráficos de dispersión presentan los datos como un conjunto de puntos.

Un gráfico de área se implementa utilizando la clase QAreaSeries o el tipo QML AreaSeries. De forma predeterminada, el eje x se utiliza como uno de los límites y QLineSeries o LineSeries como el otro. Sin embargo, se puede utilizar QLineSeries o LineSeries como ambos límites.
Un gráfico de dispersión se implementa utilizando la clase QScatterSeries o el tipo QML ScatterSeries.
Para obtener más información, consulta Creación de gráficos de área y Creación de gráficos de dispersión.
Gráficos de barras
Un gráfico de barras presenta los datos como barras horizontales o verticales agrupadas por categoría. La clase QBarSet y el tipo QML BarSet representan un conjunto de barras en un gráfico de barras. La clase `QAbstractBarSeries` es una clase padre abstracta para todas las clases de series de barras, y el tipo `AbstractBarSeries` es el tipo padre de los tipos de series de barras. El tipo de serie determina cómo se presentan los datos.
La clase QBarSeries y el tipo QML BarSeries presentan los datos como barras verticales agrupadas por categoría. Del mismo modo, la clase QHorizontalBarSeries y el tipo QML HorizontalBarSeries presentan los datos como barras horizontales.

La clase QStackedBarSeries y el tipo StackedBarSeries presentan una serie de datos como barras apiladas verticalmente, con una barra por categoría. La clase y el tipo horizontales correspondientes son QHorizontalStackedBarSeries y HorizontalStackedBarSeries, respectivamente.

La clase QPercentBarSeries y el tipo QML PercentBarSeries presentan una serie de datos categorizados como porcentaje de cada categoría. La clase y el tipo horizontales correspondientes son QHorizontalPercentBarSeries y HorizontalPercentBarSeries, respectivamente.

Para obtener más información, consulta Creación de gráficos de barras, Creación de gráficos de barras apiladas horizontales, Creación de gráficos de barras horizontales y Creación de gráficos de barras porcentuales horizontales.
Gráficos circulares
Los gráficos circulares presentan los datos en forma de círculo dividido en porciones. El círculo se implementa mediante la clase QPieSeries o el tipo QML PieSeries, y las porciones se añaden mediante la clase QPieSlice o el tipo QML PieSlice.
El gráfico circular se puede convertir en un gráfico de rosquilla especificando un tamaño de agujero comprendido entre 0,0 y 1,0.

Para obtener más información, consulta la Galería de gráficos con widgets, Creación de un gráfico de desglose tipo rosquilla y Creación de gráficos de rosquilla anidados.
Gráficos de caja y bigotes
Los gráficos de caja y bigotes presentan los datos como cuartiles ampliados con bigotes que muestran la variabilidad de los valores. Los elementos de las series de diagramas de caja se agrupan por categoría, de forma similar a los conjuntos de barras en las series de barras. Para cada elemento del diagrama de caja y bigotes, se especifican el valor extremo inferior, el cuartil inferior, la mediana, el cuartil superior y el valor extremo superior.
Un gráfico de caja y bigotes se implementa utilizando las clases QBoxPlotSeries y QBoxSet o los tipos QML BoxPlotSeries y BoxSet.

Para obtener más información, consulta Creación de gráficos de caja y bigotes.
Gráficos de velas
Los gráficos de velas presentan una serie de datos representados como velas.

Un gráfico de velas se implementa utilizando las clases QCandlestickSeries y QCandlestickSet o los tipos QML CandlestickSeries y CandlestickSet.
Gráficos polares
Los gráficos polares presentan los datos en un gráfico circular, donde la ubicación de los datos se basa en el ángulo y la distancia respecto al centro del gráfico, el polo.

La clase QPolarChart es una especialización de la clase QChart. Admite series de líneas, splines, áreas y dispersión, así como todos los tipos de ejes compatibles con ellas. El eje puede utilizarse como eje radial o angular. En QML, el tipo correspondiente es PolarChartView.
Para obtener más información, consulta Creación de gráficos polares y Uso de gráficos polares con QML.
Ejes
Qt Charts admite los siguientes tipos de ejes:
- Eje de valores
- Eje de categorías
- Eje de categorías de barras
- Eje de fecha y hora
- Eje de valores logarítmico
Un eje puede configurarse para mostrar una línea con marcas de graduación, líneas de cuadrícula y sombreados. Los valores del eje se trazan en las posiciones de las marcas de graduación. Todos los tipos de eje son especializaciones de la clase QAbstractAxis o del tipo QML AbstractAxis.
Un eje de valores añade valores reales al eje de un gráfico. Se implementa mediante la clase QValueAxis o el tipo QML ValueAxis.
Un eje de categorías se implementa mediante la clase QCategoryAxis o el tipo QML CategoryAxis. Cuenta con rangos con nombre y anchos de rango ajustables.
El eje de categorías de barras es similar a un eje de categorías, pero el ancho de rango es el mismo para todos los rangos. Un eje de categorías de barras se implementa mediante la clase QBarCategoryAxis o el tipo QML BarCategoryAxis.
Un eje de fecha y hora añade fechas y horas al eje de un gráfico. Se implementa mediante la clase QDateTimeAxis o el tipo QML DateTimeAxis.
Un eje logarítmico añade una escala logarítmica al eje de un gráfico. Una escala logarítmica es una escala no lineal basada en órdenes de magnitud, de modo que cada marca del eje es la marca anterior multiplicada por un valor. Un eje logarítmico se implementa mediante la clase QLogValueAxis o el tipo QML LogValueAxis.
Se pueden definir varios ejes para un mismo gráfico. Los ejes se pueden colocar debajo, encima, a la izquierda o a la derecha del gráfico. Además, los ejes pueden ser de diferentes tipos. Sin embargo, no se admite la combinación de tipos de ejes que darían lugar a dominios diferentes, como especificar QValueAxis y QLogValueAxis en la misma orientación.
Para obtener más información, consulta «Gráficos de líneas con ejes de fecha y hora», «Uso de ejes de valores logarítmicos», «Uso de múltiples ejes» y «Uso de ejes con QML».
Leyenda
Una leyenda es un objeto gráfico que muestra la leyenda de un gráfico. Los objetos de leyenda no se pueden crear ni eliminar, pero se puede hacer referencia a ellos a través de la clase QChart o del tipo QML ChartView. QChart o ChartView actualizan el estado de la leyenda cuando cambian las series.
Una leyenda puede colocarse debajo o encima del gráfico, así como a la izquierda o a la derecha del mismo. Por defecto, la leyenda está unida a la vista del gráfico, pero puede separarse para convertirla en un elemento gráfico independiente que se puede mover libremente.
Es posible ocultar tanto marcadores individuales de la leyenda como la leyenda completa.
Los marcadores de la leyenda se pueden modificar utilizando la clase base QLegendMarker y las subclases correspondientes a cada tipo de serie: QAreaLegendMarker, QBarLegendMarker, QBoxPlotLegendMarker, QCandlestickLegendMarker y QXYLegendMarker.
En QML, los marcadores de leyenda se pueden modificar creando leyendas personalizadas, tal y como se ilustra en el ejemplo «Personalización de leyendas ».
Interacción con los gráficos
Los usuarios finales pueden interactuar con los gráficos añadiendo valores de forma dinámica, profundizando en los datos, ampliando y reduciendo los gráficos, desplazándose por ellos y haciendo clic en elementos de los gráficos o pasando el ratón por encima de ellos.
Trazado dinámico de datos
Es posible añadir datos a los gráficos de forma dinámica y hacer que la vista del gráfico se desplace automáticamente para mostrar los nuevos datos.
Para obtener más información, consulta Creación de gráficos de spline.
Desglose de datos
Los efectos de desglose se pueden aplicar, por ejemplo, a gráficos de barras o circulares. Cuando los usuarios seleccionan un elemento del gráfico, se muestra una vista más detallada del mismo. Esto se consigue eliminando la primera serie y añadiendo otra.
Para obtener más información, consulta «Implementación del desglose».
Zoom y desplazamiento
Los usuarios pueden utilizar el teclado para ampliar y desplazarse. Pueden desplazarse por los gráficos con las teclas de flecha y ampliar o reducir los gráficos con las teclas más y menos. Además, se puede utilizar la función « QRubberBand » para seleccionar el área que se desea ampliar.
En dispositivos táctiles, se pueden utilizar gestos para desplazarse y ampliar o reducir la imagen.
Para obtener más información, consulta «Ejemplo de línea de zoom».
Hacer clic y pasar el cursor
Puede conectar ranuras a las señales emitidas cuando los usuarios finales hacen clic en elementos de los gráficos o pasan el ratón por encima de ellos. Esto le permite añadir elementos, como llamadas, a los gráficos.
Para obtener más información, consulta Dibujar una leyenda sobre un gráfico.
Temas
Un tema es una colección integrada de ajustes relacionados con el estilo de la interfaz de usuario que se aplica a todos los elementos visuales de un gráfico, como los colores, los lápices, los pinceles y las fuentes de las series, así como a los ejes, el título y la leyenda.

Qt Charts Incluye los siguientes temas predefinidos:
- Tema claro, que es el tema predeterminado
- Tema azul cerúleo
- Tema oscuro
- Tema marrón arena
- Tema azul del Sistema de Colores Naturales (NCS)
- Tema de alto contraste
- Tema azul hielo
- Tema Qt
Los temas se pueden personalizar cambiando los colores, los rotuladores, los pinceles y las fuentes. Se pueden añadir nuevos temas modificando el código fuente de Qt Charts.
Nota: Al cambiar el tema, se sobrescribirán todas las personalizaciones aplicadas anteriormente a la serie.
Para obtener más información, consulta la sección «Creación de gráficos con temas».
© 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.