En esta página

BarModelMapper QML Type

Modelador de 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 mapeador de modelos 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.

Se pueden utilizar tanto las propiedades del modelo como las de la serie de barras para manipular los datos. El mapeador de modelos mantiene sincronizadas la serie 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 que se realice el mismo cambio en todos los conjuntos de barras de la serie.

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 el encabezado 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 también es el mínimo. El recuento está limitado por el número de filas o 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. Debes implementar el modelo y hacerlo visible para QML.

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

orientation : orientation

Indica al modelmapper cómo asignar 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. Cuando la orientación se establece en « 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 al asignarla al mapeador. Cuando se especifica una nueva serie, la antigua se desconecta, pero conserva sus datos.

Documentación de Signal

countChanged()

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

Nota: El controlador correspondiente es onCountChanged.

firstBarSetSectionChanged()

Esta señal se emite cuando cambia la primera sección de compases.

Nota: El controlador correspondiente es onFirstBarSetSectionChanged.

firstChanged()

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

Nota: El controlador correspondiente es onFirstChanged.

lastBarSetSectionChanged()

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

Nota: El controlador correspondiente es onLastBarSetSectionChanged.

modelChanged()

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

Nota: El controlador correspondiente es onModelChanged.

orientationChanged()

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

Nota: El controlador correspondiente es onOrientationChanged.

orientationChanged()

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

Nota: El controlador correspondiente es onOrientationChanged.

seriesChanged()

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

Nota: El controlador 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.