CandlestickSeries QML Type
Representa una serie de datos en forma de velas. Más...
| Import Statement: | import QtCharts 2.11 |
| Since: | QtCharts 2.2 |
| In C++: | QCandlestickSeries |
| Inherits: |
Propiedades
- axisX : AbstractAxis
- axisXTop : AbstractAxis
- axisY : AbstractAxis
- axisYRight : AbstractAxis
- bodyOutlineVisible : bool
- bodyWidth : real
- brushFilename : string
- capsVisible : bool
- capsWidth : real
- count : int
- decreasingColor : color
- increasingColor : color
- maximumColumnWidth : real
- minimumColumnWidth : real
Señales
- candlestickSetsAdded(list<CandlestickSet> sets)
- candlestickSetsRemoved(list<CandlestickSet> sets)
- clicked(CandlestickSet set)
- doubleClicked(CandlestickSet set)
- hovered(bool status, CandlestickSet set)
- pressed(CandlestickSet set)
- released(CandlestickSet set)
Métodos
- bool append(CandlestickSet set)
- CandlestickSet at(int index)
- void clear()
- bool insert(int index, CandlestickSet set)
- bool remove(CandlestickSet set)
Descripción detallada
El tipo CandlestickSeries actúa como contenedor de elementos candlestick individuales. Cada elemento se dibuja en su propia categoría cuando se utiliza BarCategoryAxis. DateTimeAxis y ValueAxis pueden utilizarse como alternativa a BarCategoryAxis. En este caso, cada elemento candlestick se dibuja según su valor de marca de tiempo.
Nota: Las marcas de tiempo deben ser únicas dentro de una CandlestickSeries. Cuando se utiliza BarCategoryAxis, sólo se dibuja la primera de las velas que comparten una marca de tiempo. Si el gráfico incluye múltiples instancias de CandlestickSeries, los elementos de diferentes series que comparten una marca de tiempo se dibujan en la misma categoría. Cuando se utiliza ValueAxis o DateTimeAxis, los elementos de velas que comparten una marca de tiempo se superponen entre sí.
El siguiente QML muestra cómo crear un gráfico de velas simple:
import QtQuick 2.5 import QtCharts 2.2 ChartView { title: "Candlestick Series" width: 400 height: 300 CandlestickSeries { name: "Acme Ltd." increasingColor: "green" decreasingColor: "red" CandlestickSet { timestamp: 1435708800000; open: 690; high: 694; low: 599; close: 660 } CandlestickSet { timestamp: 1435795200000; open: 669; high: 669; low: 669; close: 669 } CandlestickSet { timestamp: 1436140800000; open: 485; high: 623; low: 485; close: 600 } CandlestickSet { timestamp: 1436227200000; open: 589; high: 615; low: 377; close: 569 } CandlestickSet { timestamp: 1436313600000; open: 464; high: 464; low: 254; close: 254 } } }
Véase también CandlestickSet, BarCategoryAxis, DateTimeAxis, y ValueAxis.
Documentación de propiedades
axisX : AbstractAxis
El eje x utilizado para la serie. Si deja axisX y axisXTop sin definir, se crea un eje de valores para la serie.
Véase también axisXTop y ValueAxis.
axisXTop : AbstractAxis
El eje x utilizado para la serie, dibujado en la parte superior de la vista del gráfico.
Nota: Sólo puede proporcionar axisX o axisXTop, no ambos.
Véase también axisX.
axisY : AbstractAxis
El eje y utilizado para la serie. Si deja ambos axisY y axisYRight sin definir, se crea un eje de valores para la serie.
Véase también axisYRight y ValueAxis.
axisYRight : AbstractAxis
El eje Y utilizado para la serie, dibujado a la derecha en la vista del gráfico.
Nota: Sólo puede proporcionar axisY o axisYRight, no ambos.
Véase también axisY.
bodyOutlineVisible : bool
La visibilidad de los contornos del cuerpo de la vela.
bodyWidth : real
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.
brushFilename : string
El nombre del archivo utilizado como imagen de pincel para la serie.
capsVisible : bool
La visibilidad de los tapones.
capsWidth : real
La anchura relativa 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.
count : int [read-only]
El número de candelabros de una serie.
decreasingColor : color
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.
increasingColor : color
El color del cuerpo del elemento vela creciente. Una vela es creciente cuando su valor de cierre es mayor que el valor de apertura. Por defecto, esta propiedad se establece en el color del pincel. El color por defecto se utiliza también cuando la propiedad se establece en un valor de color no válido.
maximumColumnWidth : real
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.
minimumColumnWidth : real
La anchura mínima de los elementos de la vela en píxeles. Establecer un valor negativo significa que no hay anchura mínima. Todos los valores negativos se convierten a -1.0.
Documentación de señales
candlestickSetsAdded(list<CandlestickSet> sets)
Esta señal se emite cuando los elementos de vela especificados por sets se añaden a la serie.
El manejador de señal correspondiente es onCandlestickSetsAdded.
Nota: El manejador correspondiente es onCandlestickSetsAdded.
candlestickSetsRemoved(list<CandlestickSet> sets)
Esta señal se emite cuando los elementos de vela especificados por sets se eliminan de la serie.
El manejador de señal correspondiente es onCandlestickSetsRemoved.
Nota: El manejador correspondiente es onCandlestickSetsRemoved.
clicked(CandlestickSet set)
Esta señal se emite cuando se hace clic en el elemento de vela especificado por set en el gráfico.
El manejador de señal correspondiente es onClicked.
Nota: El manejador correspondiente es onClicked.
doubleClicked(CandlestickSet set)
Esta señal se emite cuando se hace doble clic en el elemento de vela especificado por set en el gráfico.
El manejador de señal correspondiente es onDoubleClicked.
Nota: El manejador correspondiente es onDoubleClicked.
hovered(bool status, CandlestickSet 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.
La señal correspondiente es onHovered.
Nota: El manejador correspondiente es onHovered.
pressed(CandlestickSet 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.
El manejador de señal correspondiente es onPressed.
Nota: El manejador correspondiente es onPressed.
released(CandlestickSet set)
Esta señal se emite cuando el usuario suelta la tecla del ratón sobre el elemento de la vela especificado por set.
El manejador de señal correspondiente es onReleased.
Nota: El manejador correspondiente es onReleased.
Documentación del método
bool append(CandlestickSet 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.
CandlestickSet at(int index)
Devuelve el elemento de la vela en la posición especificada por index. Devuelve null si el índice no es válido.
void clear()
Elimina todos los elementos de vela de la serie y los borra permanentemente.
bool insert(int index, CandlestickSet 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.
bool remove(CandlestickSet 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.
© 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.
