En esta página

VCandlestickModelMapper QML Type

Mapeador de modelos verticales para una serie de candeleros. Más...

Import Statement: import QtCharts 2.11
Since: QtCharts 2.2
In C++: QVCandlestickModelMapper

Propiedades

Descripción detallada

Los mapeadores de modelos permiten utilizar un modelo de datos derivado de la clase QAbstractItemModel como fuente de datos para un gráfico. Un mapeador de modelo vertical se utiliza para crear una conexión entre un modelo de datos y CandlestickSeries, de forma que cada columna del modelo de datos defina un elemento candlestick y cada fila se asigne a los valores de apertura, máximo, mínimo, cierre y marca de tiempo del elemento candlestick.

Tanto las propiedades del modelo como las de la serie de velas pueden utilizarse para manipular los datos. El mapeador del modelo mantiene sincronizadas las series de velas y el modelo de datos.

El mapeador del modelo asegura que todos los elementos de la serie de velas tienen el mismo tamaño. Por lo tanto, al añadir o eliminar un valor de un elemento de candelero, se produce el mismo cambio en todos los elementos de candelero de la serie de candeleros.

El siguiente ejemplo QML crea una serie de velas con tres elementos de velas (suponiendo que el modelo tiene al menos cuatro columnas). Cada elemento candlestick contiene datos definidos por las filas timestamp, open, high, low y close. El nombre de un elemento viene definido por la cabecera horizontal de la columna.

CandlestickSeries {
    VCandlestickModelMapper {
        model: myCustomModel // QAbstractItemModel derived implementation
        timestampRow: 1
        openRow: 2
        highRow: 3
        lowRow: 4
        closeRow: 5
        firstSetColumn: 1
        lastSetColumn: 3
    }
}

Véase también CandlestickSeries, CandlestickSet, y HCandlestickModelMapper.

Documentación de propiedades

closeRow : int

La fila del modelo que contiene los valores de cierre de las velas de la serie. El valor por defecto es -1 (asignación no válida).

firstSetColumn : int

La columna del modelo que se utiliza como fuente de datos para el primer elemento. El valor por defecto es -1 (asignación no válida).

highRow : int

La fila del modelo que contiene los valores altos de las velas de la serie. El valor por defecto es -1 (asignación no válida).

lastSetColumn : int

La columna del modelo que se utiliza como fuente de datos para el último elemento. El valor por defecto es -1 (asignación no válida).

lowRow : int

La fila del modelo que contiene los valores bajos de las velas de la serie. El valor por defecto es -1 (asignación no válida).

model : QAbstractItemModel

El modelo basado en QAbstractItemModel que utiliza el mapeador. El modelo debe estar implementado y expuesto a QML.

Nota: El modelo utilizado debe permitir añadir y eliminar filas o columnas y modificar los datos de las celdas.

openRow : int

La fila del modelo que contiene los valores abiertos de las velas de la serie. El valor por defecto es -1 (asignación no válida).

series : CandlestickSeries

El objeto basado en CandlestickSeries que utiliza el mapeador.

Todos los datos de la serie se descartan cuando se establece en el mapeador. Cuando se especifica una nueva serie, la antigua se desconecta (pero conserva sus datos).

timestampRow : int

La fila del modelo que contiene los valores de marca de tiempo de los elementos de vela de la serie. El valor por defecto es -1 (asignación no válida).

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