En esta página

BarModelMapper QML Type

Mapeador de modelos para series de barras. Más...

Import Statement: import QtGraphs
In C++: QBarModelMapper

Propiedades

Señales

Descripción detallada

El tipo BarModelMapper permite utilizar un modelo de datos derivado de la clase QAbstractItemModel como fuente de datos para un gráfico. Un model mapper se utiliza para crear una conexión entre un modelo de datos y QBarSeries. Es necesario implementar el modelo de datos y exponerlo a QML.

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

El mapeador de modelos garantiza que todos los conjuntos de barras de la serie de barras tengan el mismo tamaño. Por lo tanto, añadir o eliminar un valor de un conjunto de barras provoca el mismo cambio en todos los conjuntos de barras de la serie de barras.

El siguiente fragmento de código QML crea una serie de barras con tres conjuntos de barras (suponiendo que el modelo tenga al menos cuatro columnas). Cada conjunto de barras contiene datos a partir de la fila 1. El nombre de un conjunto de barras viene definido por la cabecera de la columna.

BarSeries {
    BarModelMapper {
        model: myCustomModel // QAbstractItemModel derived implementation
        firstBarSetColumn: 1
        lastBarSetColumn: 3
        firstRow: 1
        orientation: Qt.Vertical
    }
}

Documentación de propiedades

count : qsizetype

El número de filas o columnas del modelo que se asignan como datos para la serie de barras. El valor por defecto es -1 que es también el mínimo. El recuento está limitado por el número de filas/columnas del modelo.

Véase también orientation.

first : qsizetype

La fila o columna del modelo que contiene los primeros valores de los conjuntos de barras de la serie de barras. El valor por defecto es 0.

Véase también orientation.

firstBarSetSection : qsizetype

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

Véase también orientation.

lastBarSetSection : qsizetype

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

Véase también orientation.

model : model

El modelo de datos que utiliza el mapeador. Es necesario implementar el modelo y exponerlo a QML.

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

orientation : orientation

Indica al modelmapper cómo mapear los datos de un modelo. Si se utiliza Qt.Vertical, cada una de las columnas del modelo define un conjunto de barras, y las filas del modelo definen las categorías. Si la orientación es Qt.Horizontal, cada una de las filas del modelo define un conjunto de barras, y las columnas del modelo definen las categorías.

series : BarSeries

La serie de barras que utiliza el mapeador. Todos los datos de la serie se descartan cuando se establece en el mapeador. Cuando se especifica la nueva serie, la antigua se desconecta, pero conserva sus datos.

Documentación de la señal

countChanged()

Esta señal se emite cuando cambia el número de filas o columnas.

Nota: El manejador correspondiente es onCountChanged.

firstBarSetSectionChanged()

Esta señal se emite cuando cambia la sección del primer conjunto de compases.

Nota: El manejador correspondiente es onFirstBarSetSectionChanged.

firstChanged()

Esta señal se emite cuando cambia la primera fila o columna.

Nota: El manejador correspondiente es onFirstChanged.

lastBarSetSectionChanged()

Esta señal se emite cuando cambia la última sección del conjunto de compases.

Nota: El manejador correspondiente es onLastBarSetSectionChanged.

modelChanged()

Esta señal se emite cuando cambia el modelo al que está conectado el mapeador.

Nota: El manejador correspondiente es onModelChanged.

orientationChanged()

Esta señal se emite cuando cambia la orientación.

Nota: El manejador correspondiente es onOrientationChanged.

orientationChanged()

Esta señal se emite cuando cambia la orientación.

Nota: El manejador correspondiente es onOrientationChanged.

seriesChanged()

Esta señal se emite cuando cambia la serie de barras a la que está conectado el mapeador.

Nota: El manejador correspondiente es onSeriesChanged.

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