QCandlestickSeries Class
La clase QCandlestickSeries presenta los datos como candeleros. Más...
| Header: | #include <QCandlestickSeries> |
| In QML: | CandlestickSeries |
| Inherits: | QAbstractSeries |
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 candelero individuales. Cada elemento se dibuja en su propia categoría cuando se utiliza QBarCategoryAxis. QDateTimeAxis y QValueAxis se pueden utilizar como alternativas a QBarCategoryAxis. En este caso, cada elemento candlestick se dibuja de acuerdo con su valor de marca de tiempo.
Nota: Las marcas de tiempo deben ser únicas dentro de una QCandlestickSeries. Cuando se utiliza QBarCategoryAxis, sólo se dibuja el primero de los elementos de vela que comparten una marca de tiempo. Si el gráfico incluye múltiples instancias de QCandlestickSeries, los elementos de diferentes series que comparten una marca de tiempo se dibujan en la misma categoría. Cuando se utiliza QValueAxis o QDateTimeAxis, los elementos candlestick que comparten una marca de tiempo se solaparán entre sí.
Consulte 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 mantiene 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 la anchura relativa del elemento candelabro dentro de su propia ranura, en el rango de 0.0 a 1.0.
Los valores fuera de este rango se fijan en 0.0 o 1.0.
Funciones de acceso:
| qreal | bodyWidth() const |
| void | setBodyWidth(qreal bodyWidth) |
Señal del notificador:
| void | bodyWidthChanged() |
brush : QBrush
Esta propiedad contiene el pincel utilizado para rellenar los elementos de la vela.
Funciones de acceso:
| QBrush | brush() const |
| void | setBrush(const QBrush &brush) |
Señal del notificador:
| void | brushChanged() |
capsVisible : bool
Esta propiedad contiene la visibilidad de las tapas.
Funciones de acceso:
| bool | capsVisible() const |
| void | setCapsVisible(bool capsVisible) |
Señal del notificador:
| void | capsVisibilityChanged() |
capsWidth : qreal
Esta propiedad mantiene el ancho relativo de las tapas dentro de una vela, en el rango de 0.0 a 1.0.
Los valores fuera de este rango se fijan en 0.0 o 1.0.
Funciones de acceso:
| qreal | capsWidth() const |
| void | setCapsWidth(qreal capsWidth) |
Señal de aviso:
| void | capsWidthChanged() |
[read-only] count : int
Esta propiedad contiene el número de velas de una serie.
Funciones de acceso:
| int | count() const |
Señal de aviso:
| void | countChanged() |
decreasingColor : QColor
Esta propiedad contiene el color del cuerpo de la vela decreciente.
Una vela es decreciente cuando su valor de apertura es mayor que el de cierre. Por defecto, esta propiedad se establece en el color del pincel con el canal alfa establecido en 128. El color por defecto se utiliza también 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 del notificador:
| void | decreasingColorChanged() |
increasingColor : QColor
Esta propiedad contiene el color del cuerpo de la vela creciente.
Una vela es creciente cuando su valor de cierre es mayor que el valor de apertura. Por defecto, esta propiedad tiene el color del pincel. El color por defecto se utiliza también cuando la propiedad se establece a un valor de color no válido.
Funciones de acceso:
| QColor | increasingColor() const |
| void | setIncreasingColor(const QColor &increasingColor) |
Señal de aviso:
| void | increasingColorChanged() |
maximumColumnWidth : qreal
Esta propiedad contiene la anchura máxima de los elementos de la vela en píxeles. Establecer un valor negativo significa que no hay anchura máxima. Todos los valores negativos se convierten a -1.0.
Funciones de acceso:
| qreal | maximumColumnWidth() const |
| void | setMaximumColumnWidth(qreal maximumColumnWidth) |
Señal del notificador:
| void | maximumColumnWidthChanged() |
minimumColumnWidth : qreal
Esta propiedad contiene la anchura mínima de los elementos de la vela en píxeles. Un valor negativo significa que no hay anchura mínima. Todos los valores negativos se convierten a -1.0.
Funciones de acceso:
| qreal | minimumColumnWidth() const |
| void | setMinimumColumnWidth(qreal minimumColumnWidth) |
Señal del notificador:
| void | minimumColumnWidthChanged() |
pen : QPen
Esta propiedad contiene la pluma utilizada para dibujar las líneas de los elementos de las velas.
Funciones de acceso:
| QPen | pen() const |
| void | setPen(const QPen &pen) |
Señal del notificador:
| void | penChanged() |
Documentación de funciones miembro
[explicit] QCandlestickSeries::QCandlestickSeries(QObject *parent = nullptr)
Construye un QCandlestickSeries vacío. El parent es opcional.
[virtual noexcept] QCandlestickSeries::~QCandlestickSeries()
Destruye la serie. Elimina la serie del gráfico.
bool QCandlestickSeries::append(QCandlestickSet *set)
Añade un único elemento de vela especificado por set a la serie y se apropia de él. Si el elemento es nulo o ya está en la serie, no se añade. Devuelve true si la adición tuvo éxito, false en caso contrario.
bool QCandlestickSeries::append(const QList<QCandlestickSet *> &sets)
Añade una lista de elementos de velas especificados por sets a la serie y toma posesión de ella. Si alguno de los elementos es nulo, ya pertenece a la serie, o aparece en la lista más de una vez, no se añade nada. Devuelve true si todos los elementos se han añadido correctamente, false en caso contrario.
[signal] void QCandlestickSeries::bodyOutlineVisibilityChanged()
Esta señal se emite cuando cambia la visibilidad del contorno del cuerpo del elemento vela.
Nota: Señal notificadora de la propiedad bodyOutlineVisible.
Véase también bodyOutlineVisible.
[signal] void QCandlestickSeries::bodyWidthChanged()
Esta señal se emite cuando cambia el ancho del elemento candlestick.
Nota: Señal notificadora para la propiedad bodyWidth.
Véase también bodyWidth.
[signal] void QCandlestickSeries::brushChanged()
Esta señal se emite cuando cambia el pincel del elemento candelabro.
Nota: Señal notificadora para la propiedad brush.
Véase también brush.
[signal] void QCandlestickSeries::candlestickSetsAdded(const QList<QCandlestickSet *> &sets)
Esta señal se emite cuando los elementos de vela especificados por sets se añaden a la serie.
[signal] void QCandlestickSeries::candlestickSetsRemoved(const QList<QCandlestickSet *> &sets)
Esta señal se emite cuando los elementos de vela especificados por sets se eliminan de la serie.
[signal] void QCandlestickSeries::capsVisibilityChanged()
Esta señal se emite cuando cambia la visibilidad de las tapas de los elementos de las velas.
Nota: Señal notificadora de la propiedad capsVisible.
Véase también capsVisible.
[signal] void QCandlestickSeries::capsWidthChanged()
Esta señal se emite cuando cambia el ancho de la tapa del elemento candelabro.
Nota: Señal notificadora para la propiedad capsWidth.
Véase también capsWidth.
void QCandlestickSeries::clear()
Elimina todos los elementos de vela de la serie y los borra permanentemente.
[signal] void QCandlestickSeries::clicked(QCandlestickSet *set)
Esta señal se emite cuando se hace clic en el elemento de vela especificado por set en el gráfico.
int QCandlestickSeries::count() const
Devuelve el número de velas de la serie.
Nota: Función Getter 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ñal notificadora de la propiedad count.
Véase también count.
[signal] void QCandlestickSeries::decreasingColorChanged()
Esta señal se emite cuando cambia el color decreciente del elemento vela.
Nota: Señal notificadora para la propiedad decreasingColor.
Véase también decreasingColor.
[signal] void QCandlestickSeries::doubleClicked(QCandlestickSet *set)
Esta señal se emite cuando se hace doble clic en el elemento de vela especificado por set en el gráfico.
[signal] void QCandlestickSeries::hovered(bool status, QCandlestickSet *set)
Esta señal se emite cuando se pasa el ratón por encima del elemento de vela especificado por set en un gráfico.
Cuando el ratón se mueve sobre el elemento, status se convierte en true, y cuando el ratón se aleja de nuevo, se convierte en false.
[signal] void QCandlestickSeries::increasingColorChanged()
Esta señal se emite cuando cambia el color creciente del elemento vela.
Nota: Señal notificadora 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 especificada por index. Toma posesión del elemento. Si el elemento es nulo o ya pertenece a la serie, no se inserta. Devuelve true si la inserción tuvo éxito, false en caso contrario.
[signal] void QCandlestickSeries::maximumColumnWidthChanged()
Esta señal se emite cuando se produce un cambio en el ancho máximo de columna de los elementos candlestick.
Nota: Señal notificadora de 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 candlestick.
Nota: Señal notificadora de la propiedad minimumColumnWidth.
Véase también minimumColumnWidth.
[signal] void QCandlestickSeries::penChanged()
Esta señal se emite cuando cambia el lápiz de la posición de la vela.
Nota: Señal notificadora 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 la pulsación del ratón sobre el elemento de la vela especificado 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 ha eliminado correctamente, false en caso contrario.
bool QCandlestickSeries::remove(const QList<QCandlestickSet *> &sets)
Elimina de la serie una lista de elementos de velas especificados por sets. Si alguno de los elementos es nulo, ya ha sido eliminado de la serie o aparece en la lista más de una vez, no se elimina nada. Devuelve true si todos los elementos se han eliminado correctamente, false en caso contrario.
QList<QCandlestickSet *> QCandlestickSeries::sets() const
Devuelve la lista de elementos de vela de la serie. La propiedad de los elementos no cambia.
bool QCandlestickSeries::take(QCandlestickSet *set)
Toma un único elemento, especificado por set, de la serie. No borra el elemento. Devuelve true si la operación de toma se ha realizado correctamente, false en caso contrario.
Nota: La serie sigue siendo el objeto padre del elemento. Debe establecer el objeto padre para tomar la propiedad completa.
[override virtual] QAbstractSeries::SeriesType QCandlestickSeries::type() const
Reimplementa una función de acceso a 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.