En esta página

HCandlestickModelMapper QML Type

Mapeador de modelos horizontales para una serie de velas. Más...

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

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 horizontal se utiliza para crear una conexión entre un modelo de datos y CandlestickSeries, de modo que cada fila del modelo de datos defina un elemento de candelero y cada columna se asigne a los valores de apertura, máximo, mínimo, cierre y fecha y hora del elemento de candelero.

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 vela (suponiendo que el modelo tiene al menos cuatro filas). Cada elemento de vela contiene datos definidos por las columnas timestamp, open, high, low y close. El nombre de un elemento viene definido por la cabecera vertical de la fila.

CandlestickSeries {
    HCandlestickModelMapper {
        model: myCustomModel // QAbstractItemModel derived implementation
        timestampColumn: 1
        openColumn: 2
        highColumn: 3
        lowColumn: 4
        closeColumn: 5
        firstSetRow: 1
        lastSetRow: 3
    }
}

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

Documentación de propiedades

closeColumn : int

La columna 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).

firstSetRow : int

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

highColumn : int

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

lastSetRow : int

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

lowColumn : int

La columna 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.

openColumn : int

La columna 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 serie antigua se desconecta (conservando sus datos).

timestampColumn : int

La columna del modelo que contiene los valores timestamp de los elementos candlestick 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.