En esta página

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:

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:

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:

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:

[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:

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:

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:

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:

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.