En esta página

QCandlestickSeries Class

La clase `QCandlestickSeries` presenta los datos en forma de velas japonesas. Más información...

Header: #include <QCandlestickSeries>
In QML: CandlestickSeries
Inherits: QAbstractSeries
Status: Deprecated

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

Propiedades

Funciones públicas

QCandlestickSeries(QObject *parent = nullptr)
virtual ~QCandlestickSeries()
bool append(QCandlestickSet *set)
bool append(const QList<QCandlestickSet *> &sets)
bool bodyOutlineVisible() const
qreal bodyWidth() const
QBrush brush() const
bool capsVisible() const
qreal capsWidth() const
void clear()
int count() const
QColor decreasingColor() const
QColor increasingColor() const
bool insert(int index, QCandlestickSet *set)
qreal maximumColumnWidth() const
qreal minimumColumnWidth() const
QPen pen() const
bool remove(QCandlestickSet *set)
bool remove(const QList<QCandlestickSet *> &sets)
void setBodyOutlineVisible(bool bodyOutlineVisible)
void setBodyWidth(qreal bodyWidth)
void setBrush(const QBrush &brush)
void setCapsVisible(bool capsVisible)
void setCapsWidth(qreal capsWidth)
void setDecreasingColor(const QColor &decreasingColor)
void setIncreasingColor(const QColor &increasingColor)
void setMaximumColumnWidth(qreal maximumColumnWidth)
void setMinimumColumnWidth(qreal minimumColumnWidth)
void setPen(const QPen &pen)
QList<QCandlestickSet *> sets() const
bool take(QCandlestickSet *set)

Funciones públicas reimplementadas

virtual QAbstractSeries::SeriesType type() const override

Señales

void bodyOutlineVisibilityChanged()
void bodyWidthChanged()
void brushChanged()
void candlestickSetsAdded(const QList<QCandlestickSet *> &sets)
void candlestickSetsRemoved(const QList<QCandlestickSet *> &sets)
void capsVisibilityChanged()
void capsWidthChanged()
void clicked(QCandlestickSet *set)
void countChanged()
void decreasingColorChanged()
void doubleClicked(QCandlestickSet *set)
void hovered(bool status, QCandlestickSet *set)
void increasingColorChanged()
void maximumColumnWidthChanged()
void minimumColumnWidthChanged()
void penChanged()
void pressed(QCandlestickSet *set)
void released(QCandlestickSet *set)

Descripción detallada

Esta clase actúa como contenedor de elementos de velas japonesas individuales. Cada elemento se dibuja en su propia categoría cuando se utiliza ` QBarCategoryAxis`. Se pueden utilizar ` QDateTimeAxis ` y ` QValueAxis ` como alternativas a ` QBarCategoryAxis`. En este caso, cada elemento de vela japonesa se dibuja según el valor de su marca de tiempo.

Nota: Las marcas de tiempo deben ser únicas dentro de una QCandlestickSeries. Al utilizar QBarCategoryAxis, solo se dibuja el primer elemento de la serie de velas que comparta una marca de tiempo. Si el gráfico incluye varias instancias de QCandlestickSeries, los elementos de diferentes series que compartan una marca de tiempo se dibujan en la misma categoría. Al utilizar QValueAxis o QDateTimeAxis, los elementos de la serie de velas que compartan una marca de tiempo se superpondrán entre sí.

Consulta la Galería de gráficos con widgets para aprender a crear un gráfico de 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

Véase también QCandlestickSet, QBarCategoryAxis, QDateTimeAxis y QValueAxis.

Documentación de propiedades

bodyOutlineVisible : bool

Esta propiedad controla la visibilidad del contorno del cuerpo de la vela.

Funciones de acceso:

bool bodyOutlineVisible() const
void setBodyOutlineVisible(bool bodyOutlineVisible)

Señal del notificador:

bodyWidth : qreal

Esta propiedad contiene el ancho relativo del elemento de vela dentro de su propia ranura, en un rango comprendido entre 0,0 y 1,0.

Los valores fuera de este rango se limitan a 0,0 o 1,0.

Funciones de acceso:

qreal bodyWidth() const
void setBodyWidth(qreal bodyWidth)

Señal de notificación:

brush : QBrush

Esta propiedad contiene el pincel utilizado para rellenar los elementos de las velas japonesas.

Funciones de acceso:

QBrush brush() const
void setBrush(const QBrush &brush)

Señal de notificador:

void brushChanged()

capsVisible : bool

Esta propiedad determina la visibilidad de las mayúsculas.

Funciones de acceso:

bool capsVisible() const
void setCapsVisible(bool capsVisible)

Señal de notificador:

capsWidth : qreal

Esta propiedad indica el ancho relativo de las sombras superiores e inferiores de una vela, en un rango comprendido entre 0,0 y 1,0.

Los valores fuera de este rango se limitan a 0,0 o 1,0.

Funciones de acceso:

qreal capsWidth() const
void setCapsWidth(qreal capsWidth)

Señal de notificación:

[read-only] count : int

Esta propiedad indica el número de velas de una serie.

Funciones de acceso:

int count() const

Señal de notificación:

void countChanged()

decreasingColor : QColor

Esta propiedad define el color del cuerpo de la vela bajista.

Una vela se considera bajista cuando su valor de apertura es superior al de cierre. Por defecto, esta propiedad se establece en el color del pincel con el canal alfa fijado en 128. El color por defecto también se utiliza cuando la propiedad se establece en un valor de color no válido.

Funciones de acceso:

QColor decreasingColor() const
void setDecreasingColor(const QColor &decreasingColor)

Señal de notificación:

increasingColor : QColor

Esta propiedad contiene el color del cuerpo de la vela alcista.

Una vela se considera alcista cuando su valor de cierre es superior al valor de apertura. Por defecto, esta propiedad se establece en el color del pincel. El color por defecto también se utiliza cuando la propiedad se establece en un valor de color no válido.

Funciones de acceso:

QColor increasingColor() const
void setIncreasingColor(const QColor &increasingColor)

Señal de notificación:

maximumColumnWidth : qreal

Esta propiedad establece el ancho máximo de los elementos de velas japonesas en píxeles. Si se establece un valor negativo, significa que no hay un ancho máximo. Todos los valores negativos se convierten en -1,0.

Funciones de acceso:

qreal maximumColumnWidth() const
void setMaximumColumnWidth(qreal maximumColumnWidth)

Señal de notificación:

minimumColumnWidth : qreal

Esta propiedad establece el ancho mínimo de los elementos de las velas en píxeles. Si se establece un valor negativo, significa que no hay ancho mínimo. Todos los valores negativos se convierten en -1,0.

Funciones de acceso:

qreal minimumColumnWidth() const
void setMinimumColumnWidth(qreal minimumColumnWidth)

Señal de notificación:

pen : QPen

Esta propiedad contiene el lápiz utilizado para dibujar las líneas de los elementos de las velas japonesas.

Funciones de acceso:

QPen pen() const
void setPen(const QPen &pen)

Señal de notificación:

void penChanged()

Documentación de las funciones de miembro

[explicit] QCandlestickSeries::QCandlestickSeries(QObject *parent = nullptr)

Crea un objeto `QCandlestickSeries` vacío. El ` parent ` es opcional.

[virtual noexcept] QCandlestickSeries::~QCandlestickSeries()

Elimina la serie. Elimina la serie del gráfico.

bool QCandlestickSeries::append(QCandlestickSet *set)

Añade a la serie un único elemento de vela especificado por ` set ` y asume su propiedad. Si el elemento es nulo o ya se encuentra en la serie, no se añade. Devuelve ` true ` si la adición se ha realizado correctamente; en caso contrario, devuelve ` false `.

bool QCandlestickSeries::append(const QList<QCandlestickSet *> &sets)

Añade a la serie una lista de elementos de velas japonesas especificados por ` sets ` y asume la propiedad de la misma. Si alguno de los elementos es nulo, ya pertenece a la serie o aparece más de una vez en la lista, no se añade nada. Devuelve ` true ` si todos los elementos se han añadido correctamente; en caso contrario, devuelve ` false `.

[signal] void QCandlestickSeries::bodyOutlineVisibilityChanged()

Esta señal se emite cuando cambia la visibilidad del contorno del cuerpo de la vela.

Nota: Señalde notificador para la propiedad bodyOutlineVisible.

Véase también « bodyOutlineVisible ».

[signal] void QCandlestickSeries::bodyWidthChanged()

Esta señal se emite cuando cambia el ancho del elemento de la vela.

Nota: Señalde notificador para la propiedad bodyWidth.

Véase también « bodyWidth ».

[signal] void QCandlestickSeries::brushChanged()

Esta señal se emite cuando cambia el pincel del elemento «vela».

Nota: Señalde notificador para la propiedad « brush ».

Véase también brush.

[signal] void QCandlestickSeries::candlestickSetsAdded(const QList<QCandlestickSet *> &sets)

Esta señal se emite cuando se añaden a la serie los elementos de velas especificados en « sets ».

[signal] void QCandlestickSeries::candlestickSetsRemoved(const QList<QCandlestickSet *> &sets)

Esta señal se emite cuando los elementos de velas japoneses especificados por « sets » se eliminan de la serie.

[signal] void QCandlestickSeries::capsVisibilityChanged()

Esta señal se emite cuando cambia la visibilidad de los límites del elemento «candlestick».

Nota: Señalde notificador para la propiedad capsVisible.

Véase también capsVisible.

[signal] void QCandlestickSeries::capsWidthChanged()

Esta señal se emite cuando cambia el ancho del elemento «candlestick».

Nota: Señalde notificador para la propiedad capsWidth.

Véase también « capsWidth ».

void QCandlestickSeries::clear()

Elimina todos los elementos de velas de la serie y los borra de forma permanente.

[signal] void QCandlestickSeries::clicked(QCandlestickSet *set)

Esta señal se emite al hacer clic en el gráfico sobre la vela especificada por « set ».

int QCandlestickSeries::count() const

Devuelve el número de elementos de velas de la serie.

Nota: Funcióngetter para la propiedad «count».

[signal] void QCandlestickSeries::countChanged()

Esta señal se emite cuando cambia el número de velas de la serie.

Nota: Señalde notificador para la propiedad count.

Véase también count.

[signal] void QCandlestickSeries::decreasingColorChanged()

Esta señal se emite cuando cambia el color de disminución del elemento de la vela.

Nota: Señalde notificador para la propiedad decreasingColor.

Véase también « decreasingColor ».

[signal] void QCandlestickSeries::doubleClicked(QCandlestickSet *set)

Esta señal se emite al hacer doble clic en el gráfico sobre el elemento de vela especificado por « set ».

[signal] void QCandlestickSeries::hovered(bool status, QCandlestickSet *set)

Esta señal se emite cuando se pasa el ratón por encima de la vela especificada por set en un gráfico.

Cuando el ratón se desplaza sobre el elemento, status cambia a true, y cuando el ratón se aleja de nuevo, cambia a false.

[signal] void QCandlestickSeries::increasingColorChanged()

Esta señal se emite cuando cambia el color del elemento de la vela.

Nota: Señalde notificador para la propiedad increasingColor.

Véase también increasingColor.

bool QCandlestickSeries::insert(int index, QCandlestickSet *set)

Inserta el elemento de vela especificado por ` set ` en la serie, en la posición indicada por ` index`. Asume la propiedad del elemento. Si el elemento es nulo o ya pertenece a la serie, no se inserta. Devuelve ` true ` si la inserción se ha realizado correctamente; en caso contrario, devuelve ` false `.

[signal] void QCandlestickSeries::maximumColumnWidthChanged()

Esta señal se emite cuando se produce un cambio en el ancho máximo de columna de los elementos de las velas japonesas.

Nota: Señalde notificación para la propiedad maximumColumnWidth.

Véase también maximumColumnWidth.

[signal] void QCandlestickSeries::minimumColumnWidthChanged()

Esta señal se emite cuando se produce un cambio en el ancho mínimo de columna de los elementos de las velas japonesas.

Nota: Señalde notificador para la propiedad minimumColumnWidth.

Véase también minimumColumnWidth.

[signal] void QCandlestickSeries::penChanged()

Esta señal se emite cuando cambia el color del lápiz del elemento de la vela.

Nota: Señalde notificador para la propiedad pen.

Véase también pen.

[signal] void QCandlestickSeries::pressed(QCandlestickSet *set)

Esta señal se emite cuando el usuario hace clic en el elemento de la vela especificado por « set » y mantiene pulsado el botón del ratón.

[signal] void QCandlestickSeries::released(QCandlestickSet *set)

Esta señal se emite cuando el usuario suelta el botón del ratón sobre la vela especificada por set.

bool QCandlestickSeries::remove(QCandlestickSet *set)

Elimina un único elemento de vela, especificado por ` set`, de la serie. Devuelve ` true ` si el elemento se elimina correctamente; en caso contrario, devuelve ` false `.

bool QCandlestickSeries::remove(const QList<QCandlestickSet *> &sets)

Elimina de la serie una lista de elementos de velas especificados mediante ` sets `. Si alguno de los elementos es nulo, ya se ha eliminado de la serie o aparece más de una vez en la lista, no se elimina nada. Devuelve ` true ` si todos los elementos se han eliminado correctamente y, en caso contrario, ` false `.

QList<QCandlestickSet *> QCandlestickSeries::sets() const

Devuelve la lista de elementos de velas japonesas de la serie. La propiedad de los elementos no cambia.

bool QCandlestickSeries::take(QCandlestickSet *set)

Extrae un único elemento de vela, especificado por ` set`, de la serie. No elimina el elemento. Devuelve ` true ` si la operación de extracción se ha realizado correctamente; ` false ` en caso contrario.

Nota: La serie sigue siendo el objeto padre del elemento. Debes establecer el objeto padre para que asuma la propiedad total.

[override virtual] QAbstractSeries::SeriesType QCandlestickSeries::type() const

Reimplementa una función de acceso para la propiedad: QAbstractSeries::type.

Devuelve el tipo de la serie (QAbstractSeries::SeriesTypeCandlestick).

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