En esta página

PieModelMapper QML Type

Mapeador de modelos para series de gráficos circulares. Más...

Import Statement: import QtGraphs
In C++: QPieModelMapper

Propiedades

Señales

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 modelos se utiliza para crear una conexión entre un modelo de datos y ` PieSeries`.

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 en QML crea una serie de gráficos circulares con cuatro sectores (suponiendo que el modelo tenga al menos cinco filas). Cada sector obtiene una etiqueta de la columna 1 y un valor de la columna 2.

PieModelMapper {
    series: pieSeries
    model: customModel
    labelsSection: 1
    valuesSection: 2
    first: 1
    count: 4
    orientation: Qt.Vertical
}

Documentación de propiedades

count : qsizetype

El número de columnas o 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).

Véase también orientation.

first : qsizetype

La columna o fila del modelo que contiene el primer valor de la sección. El valor por defecto es 0.

Véase también « orientation ».

labelsSection : qsizetype

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

Véase también orientation.

model : model

El modelo basado en « QAbstractItemModel » que utiliza el mapeador. Debes implementar el modelo y exponerlo a 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 filas del modelo define un sector del gráfico circular, y las columnas del modelo definen la etiqueta o el valor de dicho sector. Cuando la orientación se establece en « Qt.Horizontal », cada una de las columnas del modelo define un sector del gráfico circular, y las filas del modelo definen la etiqueta o el valor de dicho sector.

El valor por defecto es Qt.Vertical

series : PieSeries

La serie de gráficos circulares que utiliza el «mapper». Si defines el elemento «mapper» como elemento secundario de un « 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 anterior se desconecta (aunque conserva sus datos).

valuesSection : qsizetype

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

Véase también orientation.

Documentación de Signal

countChanged()

Esta señal se emite cuando cambia el recuento.

Nota: El controlador correspondiente es onCountChanged.

firstChanged()

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

Nota: El controlador correspondiente es onFirstChanged.

labelsSectionChanged()

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

Nota: El controlador correspondiente es onLabelsSectionChanged.

modelChanged()

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

Nota: El controlador correspondiente es onModelChanged.

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 a la que está conectado el mapeador.

Nota: El controlador correspondiente es onSeriesChanged.

valuesSectionChanged()

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

Nota: El controlador correspondiente es onValuesSectionChanged.

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