En esta página

VPieModelMapper QML Type

Mapeador de modelos vertical para series de gráficos circulares. Más información...

Import Statement: import QtCharts 2.12
In C++: QVPieModelMapper
Status: Deprecated

Este tipo está obsoleto. Recomendamos encarecidamente no utilizarlo en código nuevo.

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. Se utiliza un mapeador de modelos vertical para crear una conexión entre un modelo de datos y ` PieSeries`, de modo que cada fila del modelo de datos defina un sector del gráfico circular y cada columna se asigne a la etiqueta o al valor de dicho sector.

Se pueden utilizar tanto las propiedades del modelo como las de la serie de gráfico circular para manipular los datos. El mapeador de modelos mantiene sincronizadas la serie de gráfico circular y el modelo de datos.

El siguiente ejemplo de QML crea una serie de gráfico circular con cuatro porciones (suponiendo que el modelo tenga al menos cinco filas). Cada porción obtiene una etiqueta de la columna 1 y un valor de la columna 2.

VPieModelMapper {
    series: pieSeries
    model: customModel
    labelsColumn: 1
    valuesColumn: 2
    firstRow: 1
    rowCount: 4
}

Documentación de propiedades

firstRow : int

La fila del modelo que contiene el valor del primer segmento. El valor por defecto es 0.

labelsColumn : int

La columna del modelo que se mantiene sincronizada con las etiquetas de los sectores del gráfico circular. El valor por defecto es -1 (asignación no válida).

model : SomeModel

El modelo basado en « QAbstractItemModel » que utiliza el mapper. Debes implementar el modelo y exponerlo en QML.

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

rowCount : int

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

series : PieSeries

La serie circular que utiliza el mapper. Si defines el elemento mapper como un elemento secundario de una serie circular (PieSeries), deja esta propiedad sin definir. Todos los datos de la serie se descartan cuando se asigna al mapper. Cuando se especifica una nueva serie, la serie anterior se desconecta (aunque conserva sus datos).

valuesColumn : int

La columna del modelo que se mantiene sincronizada con los valores de los sectores del gráfico circular. 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.