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.

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:
| void | bodyOutlineVisibilityChanged() |
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:
| void | bodyWidthChanged() |
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:
| void | capsVisibilityChanged() |
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:
| void | capsWidthChanged() |
[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:
| void | decreasingColorChanged() |
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:
| void | increasingColorChanged() |
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:
| void | maximumColumnWidthChanged() |
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:
| void | minimumColumnWidthChanged() |
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.