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: | |
| 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.
| Constante | Valor | Descripción |
|---|---|---|
QChart::NoAnimation | 0x0 | La animación está desactivada en el gráfico. Este es el valor por defecto. |
QChart::GridAxisAnimations | 0x1 | La animación del eje de la cuadrícula está habilitada en el gráfico. |
QChart::SeriesAnimations | 0x2 | La animación de las series está activada en el gráfico. |
QChart::AllAnimations | 0x3 | Todos 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.
| Constante | Valor | Descripción |
|---|---|---|
QChart::ChartThemeLight | 0 | El tema claro, que es el tema predeterminado. |
QChart::ChartThemeBlueCerulean | 1 | El tema azul cerúleo. |
QChart::ChartThemeDark | 2 | El tema oscuro. |
QChart::ChartThemeBrownSand | 3 | El tema marrón arena. |
QChart::ChartThemeBlueNcs | 4 | El tema azul del sistema de colores naturales (NCS). |
QChart::ChartThemeHighContrast | 5 | El tema de alto contraste. |
QChart::ChartThemeBlueIcy | 6 | El tema azul hielo. |
QChart::ChartThemeQt | 7 | El tema Qt. |
enum QChart::ChartType
Esta enumeración describe el tipo de gráfico.
| Constante | Valor | Descripción |
|---|---|---|
QChart::ChartTypeUndefined | 0 | El tipo de gráfico no está definido. |
QChart::ChartTypeCartesian | 1 | Un gráfico cartesiano. |
QChart::ChartTypePolar | 2 | Un 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 serie | Eje horizontal (X) | Eje vertical (Y) |
|---|---|---|
| QXYSeries | QValueAxis | Eje de valor Q |
| Serie QBar | Eje de categorías de barras Q | Eje de valores Q |
| QPieSeries | Ninguno | Ninguno |
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.