En esta página

HPieModelMapper QML Type

Mapeador horizontal de modelos para la serie Pie. Más...

Import Statement: import QtCharts 2.11
In C++: QHPieModelMapper

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 PieSeries, de forma que cada columna del modelo de datos defina una porción de tarta y cada fila se asigne a la etiqueta o al valor de la porción de tarta.

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

El siguiente ejemplo QML crea una serie circular con cuatro porciones (asumiendo que el modelo tiene al menos cinco columnas). Cada porción obtiene una etiqueta de la fila 1 y un valor de la fila 2.

HPieModelMapper {
    series: pieSeries
    model: customModel
    labelsRow: 1
    valuesRow: 2
    firstColumn: 1
    columnCount: 4
}

Documentación de propiedades

columnCount : int

El número de columnas del modelo que se asignan como datos para la serie circular. El valor por defecto es -1 (número limitado por el número de columnas del modelo).

firstColumn : int

La columna del modelo que contiene el valor de la primera rebanada. El valor por defecto es 0.

labelsRow : int

La fila del modelo que se mantiene sincronizada con las etiquetas de las porciones del pastel. El valor por defecto es -1 (mapeo no válido).

model : SomeModel

El modelo basado en QAbstractItemModel 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.

series : PieSeries

El objeto PieSeries que utiliza el mapeador. Si define el elemento mapper como hijo para un PieSeries, deje esta propiedad sin definir. Todos los datos de la serie se descartan cuando se establece en el mapper. Cuando se especifica una nueva serie, la antigua se desconecta (pero conserva sus datos).

valuesRow : int

La fila del modelo que se mantiene sincronizada con los valores de las rebanadas del pastel. El valor por defecto es -1 (mapeo no válido).

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