En esta página

ItemModelBarDataProxy QML Type

Clase proxy para presentar datos en modelos de elementos con « Bars3D ». Más información...

Import Statement: import QtDataVisualization 1.12
Since: QtDataVisualization 1.0
In C++: QItemModelBarDataProxy
Inherits:

BarDataProxy

Status: Deprecated

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

Propiedades

Descripción detallada

Este tipo permite utilizar modelos derivados de `AbstractItemModel` como fuente de datos para ` Bars3D`.

Los datos se resuelven de forma asíncrona cada vez que cambia la asignación o el modelo. Se emite QBarDataProxy::arrayReset() cuando se han resuelto los datos.

Para las enumeraciones de ItemModelBarDataProxy, consulta QItemModelBarDataProxy::MultiMatchBehavior.

Para obtener más detalles, consulta la documentación de ` QItemModelBarDataProxy `.

Ejemplo de uso:

ItemModelBarDataProxy {
    itemModel: model // E.g. a list model defined elsewhere containing yearly expenses data.
    // Mapping model roles to bar series rows, columns, and values.
    rowRole: "year"
    columnRole: "city"
    valueRole: "expenses"
    rowCategories: ["2010", "2011", "2012", "2013"]
    columnCategories: ["Oulu", "Rauma", "Helsinki", "Tampere"]
}

Véase también BarDataProxy y «Qt Data Visualization: manejo de datos».

Documentación de las propiedades

autoColumnCategories : bool

Cuando se establece en « true », la asignación ignora cualquier categoría de columna definida explícitamente y las sustituye por otras generadas automáticamente cada vez que se resuelven los datos del modelo. El valor por defecto es « true ».

autoRowCategories : bool

Cuando se establece en « true », la asignación ignora cualquier categoría de fila definida explícitamente y las sustituye por otras generadas automáticamente cada vez que se resuelven los datos del modelo. El valor por defecto es « true ».

columnCategories : list<String>

Las categorías de columnas de la asignación. Solo se incluyen en la resolución de datos aquellos elementos cuyos valores de función de columna figuren en esta lista. Las columnas se ordenan siguiendo el mismo orden que en esta lista.

columnRole : string

El rol del modelo de artículo que se va a asignar a la categoría de columna.

columnRolePattern : regExp

Cuando se activa, se lleva a cabo una búsqueda y sustitución en el valor asignado por la función de columna antes de que se utilice como categoría de columna. Esta propiedad especifica la expresión regular para encontrar la parte del valor asignado que se va a sustituir, y la propiedad columnRoleReplace contiene la cadena de sustitución. Esto resulta útil, por ejemplo, para analizar las categorías de filas y columnas a partir de un único campo de marca de tiempo en el modelo de elemento.

Véase también columnRole y columnRoleReplace.

columnRoleReplace : string

Esta propiedad define el contenido de sustitución que se utilizará junto con columnRolePattern. El valor por defecto es una cadena vacía. Para obtener más información sobre cómo funciona la búsqueda y sustitución mediante expresiones regulares, consulta la documentación de la función QString::replace(const QRegularExpression &rx, const QString &after).

Véase también columnRole y columnRolePattern.

itemModel : model

El modelo del artículo.

multiMatchBehavior : ItemModelBarDataProxy.MultiMatchBehavior

Define cómo se gestionan las coincidencias múltiples para cada combinación de fila y columna. El valor predeterminado es « ItemModelBarDataProxy.MMBLast ». El comportamiento elegido afecta tanto al valor de la barra como a su rotación.

Por ejemplo, es posible que tengas un modelo de elementos con datos con marca de tiempo tomados a intervalos irregulares y quieras visualizar el valor total de los elementos de datos de cada día mediante un gráfico de barras. Esto se puede hacer especificando categorías de filas y columnas de modo que cada barra represente un día, y configurando `multiMatchBehavior` en ` ItemModelBarDataProxy.MMBCumulative`.

rotationRole : string

La función del modelo del artículo que se asigna al ángulo de rotación de la barra.

rotationRolePattern : regExp

Cuando se activa, se lleva a cabo una búsqueda y sustitución en el valor asignado por la función de rotación antes de que se utilice como ángulo de rotación de la barra. Esta propiedad especifica la expresión regular para encontrar la parte del valor asignado que se va a sustituir, y la propiedad rotationRoleReplace contiene la cadena de sustitución.

Véase también rotationRole y rotationRoleReplace.

rotationRoleReplace : string

Esta propiedad define el contenido de sustitución que se utilizará junto con rotationRolePattern. Por defecto, es una cadena vacía. Para obtener más información sobre cómo funciona la búsqueda y sustitución mediante expresiones regulares, consulta la documentación de la función QString::replace(const QRegularExpression &rx, const QString &after).

Véase también rotationRole y rotationRolePattern.

rowCategories : list<String>

Las categorías de filas de la asignación. Solo se incluyen en la resolución de datos aquellos elementos cuyos valores de función de fila figuren en esta lista. Las filas se ordenan siguiendo el mismo orden que en esta lista.

rowRole : string

El rol del modelo de artículo que se va a asignar a la categoría de fila.

rowRolePattern : regExp

Cuando se activa, se lleva a cabo una búsqueda y sustitución en el valor asignado por la función de fila antes de que se utilice como categoría de fila. Esta propiedad especifica la expresión regular para encontrar la parte del valor asignado que se va a sustituir, y la propiedad rowRoleReplace contiene la cadena de sustitución. Esto resulta útil, por ejemplo, para analizar las categorías de filas y columnas a partir de un único campo de marca de tiempo en el modelo de elemento.

Véase también rowRole y rowRoleReplace.

rowRoleReplace : string

Esta propiedad define el contenido de sustitución que se utilizará junto con ` rowRolePattern`. El valor por defecto es una cadena vacía. Para obtener más información sobre cómo funciona la búsqueda y sustitución mediante expresiones regulares, consulta la documentación de la función ` QString::replace` (`const QRegularExpression &rx, const QString &after)`.

Véase también rowRole y rowRolePattern.

useModelCategories : bool

Cuando se establece en « true », la asignación ignora los roles y las categorías de filas y columnas, y utiliza en su lugar las filas y columnas del modelo. Los encabezados de filas y columnas se utilizan como etiquetas de filas y columnas. El valor por defecto es « false ».

valueRole : string

El rol del modelo de artículo que se va a asignar al valor de la barra.

valueRolePattern : regExp

Cuando se activa, se realiza una búsqueda y sustitución en el valor asignado por la función «value» antes de que se utilice como valor de barra. Esta propiedad especifica la expresión regular para encontrar la parte del valor asignado que se va a sustituir, y la propiedad « valueRoleReplace » contiene la cadena de sustitución.

Véase también « valueRole » y « valueRoleReplace ».

valueRoleReplace : string

Esta propiedad define el contenido de sustitución que se utilizará junto con valueRolePattern. El valor por defecto es una cadena vacía. Para obtener más información sobre cómo funciona la búsqueda y sustitución mediante expresiones regulares, consulta la documentación de la función QString::replace(const QRegularExpression &rx, const QString &after).

Véase también valueRole y valueRolePattern.

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