En esta página

CandlestickSeries QML Type

Representa una serie de datos en forma de velas japonesas. Más...

Import Statement: import QtCharts 2.12
Since: QtCharts 2.2
In C++: QCandlestickSeries
Inherits:

AbstractSeries

Status: Deprecated

Este tipo está obsoleto. Recomendamos encarecidamente no utilizarlo en código nuevo.

Propiedades

Señales

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 de velas individuales. Cada elemento se dibuja en su propia categoría cuando se utiliza BarCategoryAxis. Se pueden utilizar DateTimeAxis y ValueAxis como alternativa a BarCategoryAxis. En este caso, cada elemento de vela se dibuja según su valor de marca de tiempo.

Nota: Las marcas de tiempo deben ser únicas dentro de una CandlestickSeries. Al utilizar BarCategoryAxis, 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 CandlestickSeries, los elementos de diferentes series que compartan una marca de tiempo se dibujan en la misma categoría. Al utilizar ValueAxis o DateTimeAxis, los elementos de la serie de velas que compartan una marca de tiempo se superpondrán entre sí.

El siguiente código QML muestra cómo crear un gráfico de velas sencillo:

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 }
    }
}

Captura de pantalla en la que se muestra un ejemplo de serie de velas japonesas, con el eje x representando las fechas y horas


Véase también CandlestickSet, BarCategoryAxis, DateTimeAxis y ValueAxis.

Documentación de propiedades

axisX : AbstractAxis

El eje x utilizado para la serie. Si no se definen ni «axisX» ni « axisXTop », 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 sobre la vista del gráfico.

Nota: Solose puede especificar « axisX » o «axisXTop», no ambos.

Véase también ` axisX`.

axisY : AbstractAxis

El eje Y que se utiliza para la serie. Si no se definen ni «axisY» ni « axisYRight », 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, situado a la derecha en la vista del gráfico.

Nota: Solose puede especificar « axisY » o «axisYRight», no ambos.

Véase también « axisY ».

bodyOutlineVisible : bool

La visibilidad de los contornos del cuerpo de las velas japonesas.

bodyWidth : real

La anchura relativa del elemento de la vela dentro de su propia ranura, en un intervalo comprendido entre 0,0 y 1,0. Los valores que se encuentren fuera de este intervalo se ajustan a 0,0 o 1,0.

brushFilename : string

El nombre del archivo que se utiliza como imagen de pincel para la serie.

capsVisible : bool

La visibilidad de las gorras.

capsWidth : real

La anchura relativa de los sombreros dentro de una vela, en el rango comprendido entre 0,0 y 1,0. Los valores que se sitúan fuera de este rango se limitan a 0,0 o 1,0.

count : int [read-only]

El número de velas que componen una serie.

decreasingColor : color

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.

increasingColor : color

El color del cuerpo de la vela alcista. Una vela se considera alcista cuando su valor de cierre es superior al 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.

maximumColumnWidth : real

El ancho máximo de los elementos del gráfico de velas, expresado 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.

minimumColumnWidth : real

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.

Documentación de Signal

candlestickSetsAdded(list<CandlestickSet> sets)

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

El controlador de señales correspondiente es onCandlestickSetsAdded.

Nota: El controlador correspondiente es onCandlestickSetsAdded.

candlestickSetsRemoved(list<CandlestickSet> sets)

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

El controlador de señales correspondiente es onCandlestickSetsRemoved.

Nota: El controlador correspondiente es onCandlestickSetsRemoved.

clicked(CandlestickSet set)

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

El controlador de señales correspondiente es onClicked.

Nota: El controlador correspondiente es onClicked.

doubleClicked(CandlestickSet set)

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

El controlador de señales correspondiente es onDoubleClicked.

Nota: El controlador 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 desplaza sobre el elemento, status cambia a true, y cuando el ratón se aleja de nuevo, cambia a false.

El controlador de señal correspondiente es onHovered.

Nota: El controlador 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 controlador de señales correspondiente es onPressed.

Nota: El controlador correspondiente es onPressed.

released(CandlestickSet set)

Esta señal se emite cuando el usuario suelta el botón del ratón sobre el elemento de vela especificado por set.

El controlador de señales correspondiente es onReleased.

Nota: El controlador correspondiente es onReleased.

Documentación del método

bool append(CandlestickSet set)

Añade a la serie un único elemento de vela especificado por set y asume la propiedad del mismo. 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 `.

CandlestickSet at(int index)

Devuelve el elemento de vela japonesa situado en la posición especificada por ` index`. Devuelve `null` si el índice no es válido.

void clear()

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

bool insert(int index, CandlestickSet 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, y ` 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; en caso contrario, devuelve ` false `.

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