En esta página

QChart Class

La clase QChart gestiona la representación gráfica de las series, las leyendas y los ejes del gráfico. Más información...

Header: #include <QChart>
Inherits: QGraphicsWidget
Inherited By:

QPolarChart

Status: Deprecated

Esta clase está obsoleta. Recomendamos encarecidamente no utilizarla en código nuevo.

Tipos públicos

enum AnimationOption { NoAnimation, GridAxisAnimations, SeriesAnimations, AllAnimations }
flags AnimationOptions
enum ChartTheme { ChartThemeLight, ChartThemeBlueCerulean, ChartThemeDark, ChartThemeBrownSand, ChartThemeBlueNcs, …, ChartThemeQt }
enum ChartType { ChartTypeUndefined, ChartTypeCartesian, ChartTypePolar }

Propiedades

Funciones públicas

QChart(QGraphicsItem *parent = nullptr, Qt::WindowFlags wFlags = Qt::WindowFlags())
virtual ~QChart()
void addAxis(QAbstractAxis *axis, Qt::Alignment alignment)
void addSeries(QAbstractSeries *series)
int animationDuration() const
QEasingCurve animationEasingCurve() const
QChart::AnimationOptions animationOptions() const
QList<QAbstractAxis *> axes(Qt::Orientations orientation = Qt::Horizontal|Qt::Vertical, QAbstractSeries *series = nullptr) const
QBrush backgroundBrush() const
QPen backgroundPen() const
qreal backgroundRoundness() const
QChart::ChartType chartType() const
void createDefaultAxes()
bool isBackgroundVisible() const
bool isDropShadowEnabled() const
bool isPlotAreaBackgroundVisible() const
bool isZoomed()
QLegend *legend() const
QLocale locale() const
bool localizeNumbers() const
QPointF mapToPosition(const QPointF &value, QAbstractSeries *series = nullptr)
QPointF mapToValue(const QPointF &position, QAbstractSeries *series = nullptr)
QMargins margins() const
QRectF plotArea() const
QBrush plotAreaBackgroundBrush() const
QPen plotAreaBackgroundPen() const
void removeAllSeries()
void removeAxis(QAbstractAxis *axis)
void removeSeries(QAbstractSeries *series)
void scroll(qreal dx, qreal dy)
QList<QAbstractSeries *> series() const
void setAnimationDuration(int msecs)
void setAnimationEasingCurve(const QEasingCurve &curve)
void setAnimationOptions(QChart::AnimationOptions options)
void setBackgroundBrush(const QBrush &brush)
void setBackgroundPen(const QPen &pen)
void setBackgroundRoundness(qreal diameter)
void setBackgroundVisible(bool visible = true)
void setDropShadowEnabled(bool enabled = true)
void setLocale(const QLocale &locale)
void setLocalizeNumbers(bool localize)
void setMargins(const QMargins &margins)
void setPlotArea(const QRectF &rect)
void setPlotAreaBackgroundBrush(const QBrush &brush)
void setPlotAreaBackgroundPen(const QPen &pen)
void setPlotAreaBackgroundVisible(bool visible = true)
void setTheme(QChart::ChartTheme theme)
void setTitle(const QString &title)
void setTitleBrush(const QBrush &brush)
void setTitleFont(const QFont &font)
QChart::ChartTheme theme() const
QString title() const
QBrush titleBrush() const
QFont titleFont() const
void zoom(qreal factor)
void zoomIn()
void zoomIn(const QRectF &rect)
void zoomOut()
void zoomReset()

Señales

void plotAreaChanged(const QRectF &plotArea)

Descripción detallada

QChart es un objeto de tipo « QGraphicsWidget » que se puede mostrar en un « QGraphicsScene ». 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. Para mostrar simplemente un gráfico en un diseño, se puede utilizar la clase de conveniencia QChartView en lugar de QChart. Además, las series de líneas, splines, áreas y puntos se pueden presentar como gráficos polares utilizando la clase QPolarChart.

Véase también QChartView y QPolarChart.

Documentación sobre tipos de miembros

enum QChart::AnimationOption
flags QChart::AnimationOptions

Esta enumeración describe las animaciones habilitadas en el gráfico.

ConstanteValorDescripción
QChart::NoAnimation0x0La animación está desactivada en el gráfico. Este es el valor por defecto.
QChart::GridAxisAnimations0x1La animación del eje de la cuadrícula está habilitada en el gráfico.
QChart::SeriesAnimations0x2La animación de las series está activada en el gráfico.
QChart::AllAnimations0x3Todos los tipos de animación están habilitados en el gráfico.

El tipo AnimationOptions es un typedef para QFlags<AnimationOption>. Almacena una combinación OR de valores de AnimationOption.

enum QChart::ChartTheme

Esta enumeración describe el tema utilizado por el gráfico.

Un tema es un conjunto integrado 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 trazos, los pinceles y las fuentes de las series, así como a los ejes, el título y la leyenda. La galería «Gráficos con widgets» muestra cómo utilizar los temas.

Nota: Al cambiar el tema se sobrescribirán todas las personalizaciones aplicadas anteriormente a las series.

ConstanteValorDescripción
QChart::ChartThemeLight0El tema claro, que es el tema predeterminado.
QChart::ChartThemeBlueCerulean1El tema azul cerúleo.
QChart::ChartThemeDark2El tema oscuro.
QChart::ChartThemeBrownSand3El tema marrón arena.
QChart::ChartThemeBlueNcs4El tema azul del sistema de colores naturales (NCS).
QChart::ChartThemeHighContrast5El tema de alto contraste.
QChart::ChartThemeBlueIcy6El tema azul hielo.
QChart::ChartThemeQt7El tema Qt.

enum QChart::ChartType

Esta enumeración describe el tipo de gráfico.

ConstanteValorDescripción
QChart::ChartTypeUndefined0El tipo de gráfico no está definido.
QChart::ChartTypeCartesian1Un gráfico cartesiano.
QChart::ChartTypePolar2Un gráfico polar.

Documentación de propiedades

animationDuration : int

Esta propiedad establece la duración de la animación del gráfico.

Funciones de acceso:

int animationDuration() const
void setAnimationDuration(int msecs)

animationEasingCurve : QEasingCurve

Esta propiedad contiene la curva de aceleración de la animación del gráfico.

Funciones de acceso:

QEasingCurve animationEasingCurve() const
void setAnimationEasingCurve(const QEasingCurve &curve)

animationOptions : QChart::AnimationOptions

Esta propiedad contiene las opciones de animación del gráfico.

Las animaciones se activan o desactivan en función de esta configuración.

Funciones de acceso:

QChart::AnimationOptions animationOptions() const
void setAnimationOptions(QChart::AnimationOptions options)

backgroundRoundness : qreal

Esta propiedad establece el diámetro del círculo de redondeo en las esquinas del fondo del gráfico.

Funciones de Access:

qreal backgroundRoundness() const
void setBackgroundRoundness(qreal diameter)

backgroundVisible : bool

Esta propiedad determina si el fondo del gráfico está visible.

Funciones de acceso:

bool isBackgroundVisible() const
void setBackgroundVisible(bool visible = true)

Véase también setBackgroundBrush(), setBackgroundPen() y plotAreaBackgroundVisible.

[read-only] chartType : QChart::ChartType

Esta propiedad se mantiene independientemente de si el gráfico es cartesiano o polar.

Esta propiedad se establece internamente y es de solo lectura.

Funciones de acceso:

QChart::ChartType chartType() const

Véase también QPolarChart.

dropShadowEnabled : bool

Esta propiedad determina si el efecto de sombra proyectada de fondo está activado.

Si se establece en « true », el efecto de sombra de fondo estará activado. Si se establece en « false », estará desactivado.

Nota: El efecto de sombra de fondo depende del tema, por lo que la configuración puede cambiar si se cambia el tema.

Funciones de acceso:

bool isDropShadowEnabled() const
void setDropShadowEnabled(bool enabled = true)

locale : QLocale

Esta propiedad contiene la configuración regional utilizada para dar formato a diversas etiquetas de los gráficos.

Las etiquetas se localizan únicamente cuando ` localizeNumbers ` es ` true`, salvo en el caso de las etiquetas de `QDateTimeAxis`, que siempre utilizan la ` QLocale ` establecida con esta propiedad.

El valor por defecto es la configuración regional predeterminada de la aplicación en el momento en que se crea el gráfico.

Funciones de acceso:

QLocale locale() const
void setLocale(const QLocale &locale)

Véase también ` localizeNumbers`.

localizeNumbers : bool

Esta propiedad se mantiene independientemente de si los números están localizados.

Cuando ` true`, todos los números generados que aparecen en las distintas series y etiquetas de los ejes se localizarán utilizando el formato ` QLocale ` establecido con la propiedad ` locale `. Cuando ` false`, siempre se utiliza la configuración regional C. El valor predeterminado es ` false`.

Nota: Esta propiedad no afecta a las etiquetas de QDateTimeAxis, que siempre utilizan la configuración de « QLocale » establecida con la propiedad «locale».

Funciones de acceso:

bool localizeNumbers() const
void setLocalizeNumbers(bool localize)

Véase también locale.

margins : QMargins

Esta propiedad establece los márgenes mínimos permitidos entre el borde del rectángulo del gráfico y el área de representación.

Los márgenes se utilizan para dibujar el título, los ejes y la leyenda.

Funciones de Access:

QMargins margins() const
void setMargins(const QMargins &margins)

plotArea : QRectF

Esta propiedad define el rectángulo dentro del cual se dibuja el gráfico.

El área de trazado no incluye el área definida por los márgenes. Por defecto, su tamaño se ajustará si se encuentra dentro de un QChartView. Si se establece un tamaño explícito para el área de trazado, se respetará dicho tamaño; para volver al comportamiento por defecto, basta con llamar a ` setPlotArea(QRectF()); `.

Funciones de acceso:

QRectF plotArea() const
void setPlotArea(const QRectF &rect)

Señal de notificación:

void plotAreaChanged(const QRectF &plotArea)

plotAreaBackgroundVisible : bool

Esta propiedad determina si el fondo del área de trazado del gráfico está visible.

Nota: De forma predeterminada, el fondo del área de trazado es invisible y el área de trazado utiliza el fondo general del gráfico.

Funciones de acceso:

bool isPlotAreaBackgroundVisible() const
void setPlotAreaBackgroundVisible(bool visible = true)

Véase también setPlotAreaBackgroundBrush(), setPlotAreaBackgroundPen() y backgroundVisible.

theme : QChart::ChartTheme

Esta propiedad contiene el tema utilizado para el gráfico.

Funciones de Access:

QChart::ChartTheme theme() const
void setTheme(QChart::ChartTheme theme)

title : QString

Esta propiedad contiene el título del gráfico.

El título aparece como un encabezado en la parte superior del gráfico. Los títulos de los gráficos admiten formato HTML.

Funciones de Access:

QString title() const
void setTitle(const QString &title)

Documentación de las funciones de miembro

[explicit] QChart::QChart(QGraphicsItem *parent = nullptr, Qt::WindowFlags wFlags = Qt::WindowFlags())

Crea un objeto de gráfico que es un elemento secundario de parent. Las propiedades especificadas en wFlags se pasan al constructor de QGraphicsWidget.

[virtual noexcept] QChart::~QChart()

Elimina el objeto gráfico y sus elementos secundarios, como los objetos de series y ejes que se le hayan añadido.

void QChart::addAxis(QAbstractAxis *axis, Qt::Alignment alignment)

Añade el eje axis al gráfico, alineado según se especifica en alignment. El gráfico asume la propiedad del eje.

Véanse también removeAxis(), createDefaultAxes() y QAbstractSeries::attachAxis().

void QChart::addSeries(QAbstractSeries *series)

Añade la serie series al gráfico y se hace cargo de ella.

Nota: Una serie recién añadida no se vincula a ningún eje de forma predeterminada, ni siquiera a aquellos que pudieran haberse creado para el gráfico mediante createDefaultAxes() antes de que la serie se añadiera al gráfico. Si no hay ningún eje asociado a la serie recién añadida antes de que se muestre el gráfico, la serie se dibujará como si tuviera ejes con rangos que se ajustaran exactamente a la serie en el área de trazado del gráfico. Esto puede resultar confuso si el mismo gráfico muestra también otras series que tienen ejes correctamente asociados, por lo que debes asegurarte siempre de llamar a ` createDefaultAxes()` después de añadir una serie o de asociar explícitamente ejes a la serie.

Véase también removeSeries(), removeAllSeries(), createDefaultAxes() y QAbstractSeries::attachAxis().

QList<QAbstractAxis *> QChart::axes(Qt::Orientations orientation = Qt::Horizontal|Qt::Vertical, QAbstractSeries *series = nullptr) const

Devuelve los ejes asociados a la serie series con la orientación especificada por orientation. Si no se especifica ninguna serie, se devuelven todos los ejes añadidos al gráfico con la orientación especificada.

Véase también addAxis() y createDefaultAxes().

QBrush QChart::backgroundBrush() const

Obtiene el pincel que se utiliza para pintar el fondo del área del gráfico.

Véase también setBackgroundBrush().

QPen QChart::backgroundPen() const

Obtiene el lápiz que se utiliza para pintar el fondo del área del gráfico.

Véase también setBackgroundPen().

void QChart::createDefaultAxes()

Crea ejes para el gráfico basándose en las series que ya se han añadido al mismo. Se eliminarán los ejes que se hayan añadido previamente al gráfico.

Nota: Esta función debe invocarse una vez que se hayan añadido todas las series al gráfico. Los ejes creados por esta función NO se asociarán automáticamente a ninguna serie que se añada al gráfico después de haberla invocado. Una serie sin ejes asociados se escalará, por defecto, para ocupar toda el área de trazado del gráfico, lo que puede resultar confuso si también hay otras series con ejes correctamente asociados.

Tipo de serieEje horizontal (X)Eje vertical (Y)
QXYSeriesQValueAxisEje de valor Q
Serie QBarEje de categorías de barras QEje de valores Q
QPieSeriesNingunoNinguno

Si se añaden al gráfico varias series derivadas de QXYSeries y no se ha añadido ninguna serie de otro tipo, solo se crea un par de ejes. Si se añaden al gráfico varias series de diferentes tipos, cada serie obtiene su propio par de ejes.

Los ejes específicos de la serie se pueden obtener posteriormente del gráfico indicando la serie como parámetro en la llamada a la función axes(). QPieSeries no crea ningún eje.

Véanse también axes() y QAbstractSeries::attachAxis().

bool QChart::isZoomed()

Devuelve « true » si alguna serie tiene un dominio ampliado.

QLegend *QChart::legend() const

Devuelve el objeto de leyenda del gráfico. La propiedad sigue correspondiendo al gráfico.

QPointF QChart::mapToPosition(const QPointF &value, QAbstractSeries *series = nullptr)

Devuelve la posición en el gráfico que corresponde al valor value en la serie especificada por series.

QPointF QChart::mapToValue(const QPointF &position, QAbstractSeries *series = nullptr)

Devuelve el valor de la serie especificada por series en la posición indicada por position en un gráfico.

QBrush QChart::plotAreaBackgroundBrush() const

Devuelve el pincel utilizado para rellenar el fondo del área de trazado del gráfico.

Véanse también plotArea(), plotAreaBackgroundVisible, plotAreaBackgroundPen() y setPlotAreaBackgroundBrush().

QPen QChart::plotAreaBackgroundPen() const

Devuelve el lápiz utilizado para dibujar el fondo del área de trazado del gráfico.

Véase también plotArea(), plotAreaBackgroundVisible, plotAreaBackgroundBrush() y setPlotAreaBackgroundPen().

void QChart::removeAllSeries()

Elimina y borra todos los objetos de serie que se hayan añadido al gráfico.

Véase también addSeries() y removeSeries().

void QChart::removeAxis(QAbstractAxis *axis)

Elimina el eje axis del gráfico. El gráfico libera la propiedad del objeto axis especificado.

Véanse también addAxis(), createDefaultAxes() y QAbstractSeries::detachAxis().

void QChart::removeSeries(QAbstractSeries *series)

Elimina la serie series del gráfico. El gráfico libera la propiedad del objeto series especificado.

Véase también addSeries() y removeAllSeries().

void QChart::scroll(qreal dx, qreal dy)

Desplaza el área visible del gráfico en la distancia especificada por dx y dy.

En el caso de los gráficos polares, ` dx ` indica el ángulo a lo largo del eje angular en lugar de la distancia.

QList<QAbstractSeries *> QChart::series() const

Devuelve todas las series que se han añadido al gráfico.

Véase también addSeries(), removeSeries() y removeAllSeries().

void QChart::setBackgroundBrush(const QBrush &brush)

Establece el pincel que se utiliza para pintar el fondo del área del gráfico en « brush ».

Véase también backgroundBrush().

void QChart::setBackgroundPen(const QPen &pen)

Establece el lápiz que se utiliza para pintar el fondo del área del gráfico en « pen ».

Véase también backgroundPen().

void QChart::setPlotAreaBackgroundBrush(const QBrush &brush)

Establece el pincel utilizado para rellenar el fondo del área de trazado del gráfico en « brush ».

Véase también plotArea(), plotAreaBackgroundVisible, setPlotAreaBackgroundPen() y plotAreaBackgroundBrush().

void QChart::setPlotAreaBackgroundPen(const QPen &pen)

Establece el trazo utilizado para dibujar el fondo del área de representación del gráfico en « pen ».

Véase también plotArea(), plotAreaBackgroundVisible, setPlotAreaBackgroundBrush() y plotAreaBackgroundPen().

void QChart::setTitleBrush(const QBrush &brush)

Establece el pincel utilizado para dibujar el texto del título en « brush ».

Véase también ` titleBrush()`.

void QChart::setTitleFont(const QFont &font)

Establece la fuente que se utiliza para dibujar el título del gráfico en « font ».

Véase también titleFont().

QBrush QChart::titleBrush() const

Devuelve el pincel utilizado para dibujar el texto del título.

Véase también setTitleBrush().

QFont QChart::titleFont() const

Obtiene la fuente que se utiliza para dibujar el título del gráfico.

Véase también setTitleFont().

void QChart::zoom(qreal factor)

Amplía la vista según el factor personalizado factor.

Un factor superior a 1,0 amplía la vista, mientras que un factor comprendido entre 0,0 y 1,0 la reduce.

void QChart::zoomIn()

Amplía la vista al doble.

void QChart::zoomIn(const QRectF &rect)

Amplía la vista hasta el nivel máximo en el que el rectángulo rect sigue siendo totalmente visible.

Nota: Al aplicar un zoom pueden modificarse las propiedades de los ejes asociados, por ejemplo, QAbstractAxis::min y QAbstractAxis::max.

Nota: Esta función no es compatible con los gráficos polares.

void QChart::zoomOut()

Aleja la vista a una escala de dos.

Nota: Esto no tendrá ningún efecto si el resultado contuviera un rango de eje logarítmico no válido.

void QChart::zoomReset()

Restablece los dominios de la serie a los valores que tenían antes de que se llamara a cualquier método de zoom.

Nota: Esto también restablecerá la configuración de desplazamiento y los rangos explícitos de los ejes especificados entre la primera operación de zoom y la llamada a este método. Si no se ha realizado ninguna operación de zoom, este método no realiza ninguna acción.

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