En esta página

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.

Galería de seis tipos de gráficos en el tema claro: de área, circular, de líneas, de barras, de spline y de puntos

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:

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 QtQuick

Se 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`.

Gráfico de líneas con una única línea que une puntos de datos que suben y bajan bruscamente Gráfico de spline con una única línea de curva suave que alcanza un máximo, desciende y vuelve a subir

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.

Captura de pantalla de un ejemplo de gráfico de áreas Gráfico de dispersión en el que se representan tres series mediante marcadores en forma de círculo, cuadrado y estrella

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.

Gráfico de barras verticales que agrupa los valores mensuales de cinco personas, de enero a junio Gráfico de barras horizontales que agrupa los valores mensuales de cinco personas

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.

Gráfico de barras apiladas verticalmente que muestra cinco conjuntos por mes, de enero a junio Gráfico de barras apiladas horizontales con cinco conjuntos por mes

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.

Gráfico de barras verticales en porcentaje, en el que la barra de cada mes ocupa el 100 % a lo largo de cinco conjuntos Gráfico de barras horizontal con porcentajes, en el que la barra de cada mes ocupa el 100 por ciento

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.

Captura de pantalla en la que se muestra una porción resaltada de un gráfico circular Captura de pantalla en la que se muestra una porción resaltada de un gráfico de rosquilla

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.

Gráfico de caja y bigotes que compara la desviación mensual de las acciones de dos empresas a lo largo de 2012

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.

Gráfico de velas de datos bursátiles diarios, con velas verdes que indican subidas y velas rojas que indican bajadas, a lo largo de un mes

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.

Gráfico polar con una serie de puntos dispersos y una spline verde que traza un área en forma de estrella sobre una cuadrícula circular

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.

Galería de seis tipos de gráficos en el tema «Blue Cerulean» con fondo oscuro

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.