ItemModelBarDataProxy QML Type
Clase proxy para presentar datos en modelos de elementos con Bars3D. Más...
| Import Statement: | import QtGraphs |
| In C++: | QItemModelBarDataProxy |
| Inherits: |
- Lista de todos los miembros, incluidos los heredados
- ItemModelBarDataProxy forma parte de Qt Graphs Tipos QML para 3D.
Propiedades
- autoColumnCategories : bool
- autoRowCategories : bool
- columnCategories : list<String>
- columnRole : string
- columnRolePattern : regExp
- columnRoleReplace : string
- itemModel : model
- multiMatchBehavior : enumeration
- rotationRole : string
- rotationRolePattern : regExp
- rotationRoleReplace : string
- rowCategories : list<String>
- rowRole : string
- rowRolePattern : regExp
- rowRoleReplace : string
- type : AbstractDataProxy.DataType
- useModelCategories : bool
- valueRole : string
- valueRolePattern : regExp
- valueRoleReplace : string
Señales
- autoColumnCategoriesChanged(bool enable)
- autoRowCategoriesChanged(bool enable)
- columnCategoriesChanged()
- columnRoleChanged(string role)
- columnRolePatternChanged(regExp pattern)
- columnRoleReplaceChanged(string replace)
- itemModelChanged(model itemModel)
- multiMatchBehaviorChanged(enumeration behavior)
- rotationRoleChanged(string role)
- rotationRolePatternChanged(regExp pattern)
- rotationRoleReplaceChanged(string replace)
- rowCategoriesChanged()
- rowRoleChanged(string role)
- rowRolePatternChanged(regExp pattern)
- rowRoleReplaceChanged(string replace)
- useModelCategoriesChanged(bool enable)
- valueRoleChanged(string role)
- valueRolePatternChanged(regExp pattern)
- valueRoleReplaceChanged(string replace)
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: ["2020", "2021", "2022", "2023"]
columnCategories: ["Oulu", "Rauma", "Helsinki", "Tampere"]
}Véase también BarDataProxy y Qt Graphs Manejo de datos con 3D.
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 los elementos cuyos valores de función de columna figuren en esta lista cuando se resuelven los datos. Las columnas se ordenan siguiendo el mismo orden que en esta lista.
columnRole : string
El rol del modelo de artículo que se debe asignar a la categoría de columna.
columnRolePattern : regExp
Cuando se activa, se realiza 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 : enumeration
Define cómo se gestionan las coincidencias múltiples para cada combinación de fila y columna. El valor por defecto es « ItemModelBarDataProxy.MultiMatchBehavior.Last ». El comportamiento elegido afecta tanto al valor de las barras 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.MultiMatchBehavior.Cumulative`.
rotationRole : string
La función del modelo del artículo que se va a asignar 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. 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 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.
type : AbstractDataProxy.DataType [read-only]
El tipo del proxy. Uno de los valores de QAbstractDataProxy::DataType.
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 lleva a cabo 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 localizar 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.
Documentación de Signal
autoColumnCategoriesChanged(bool enable)
Esta señal se emite cuando autoColumnCategories cambia a enable.
Nota: El controlador correspondiente es onAutoColumnCategoriesChanged.
autoRowCategoriesChanged(bool enable)
Esta señal se emite cuando autoRowCategories cambia a enable.
Nota: El controlador correspondiente es onAutoRowCategoriesChanged.
columnCategoriesChanged()
Esta señal se emite cuando cambia columnCategories.
Nota: El controlador correspondiente es onColumnCategoriesChanged.
columnRoleChanged(string role)
Esta señal se emite cuando columnRole cambia a role.
Nota: El controlador correspondiente es onColumnRoleChanged.
columnRolePatternChanged(regExp pattern)
Esta señal se emite cuando columnRolePattern cambia a pattern.
Nota: El controlador correspondiente es onColumnRolePatternChanged.
columnRoleReplaceChanged(string replace)
Esta señal se emite cuando columnRoleReplace cambia a replace.
Nota: El controlador correspondiente es onColumnRoleReplaceChanged.
itemModelChanged(model itemModel)
Esta señal se emite cuando itemModel cambia a itemModel.
Nota: El controlador correspondiente es onItemModelChanged.
multiMatchBehaviorChanged(enumeration behavior)
Esta señal se emite cuando multiMatchBehavior cambia a behavior.
Nota: El controlador correspondiente es onMultiMatchBehaviorChanged.
rotationRoleChanged(string role)
Esta señal se emite cuando rotationRole cambia a role.
Nota: El controlador correspondiente es onRotationRoleChanged.
rotationRolePatternChanged(regExp pattern)
Esta señal se emite cuando rotationRolePattern cambia a pattern.
Nota: El controlador correspondiente es onRotationRolePatternChanged.
rotationRoleReplaceChanged(string replace)
Esta señal se emite cuando rotationRoleReplace cambia a replace.
Nota: El controlador correspondiente es onRotationRoleReplaceChanged.
rowCategoriesChanged()
Esta señal se emite cuando cambia rowCategories.
Nota: El controlador correspondiente es onRowCategoriesChanged.
rowRoleChanged(string role)
Esta señal se emite cuando rowRole cambia a role.
Nota: El controlador correspondiente es onRowRoleChanged.
rowRolePatternChanged(regExp pattern)
Esta señal se emite cuando rowRolePattern cambia a pattern.
Nota: El controlador correspondiente es onRowRolePatternChanged.
rowRoleReplaceChanged(string replace)
Esta señal se emite cuando rowRoleReplace cambia a replace.
Nota: El controlador correspondiente es onRowRoleReplaceChanged.
useModelCategoriesChanged(bool enable)
Esta señal se emite cuando useModelCategories cambia a enable.
Nota: El controlador correspondiente es onUseModelCategoriesChanged.
valueRoleChanged(string role)
Esta señal se emite cuando valueRole cambia a role.
Nota: El controlador correspondiente es onValueRoleChanged.
valueRolePatternChanged(regExp pattern)
Esta señal se emite cuando valueRolePattern cambia a pattern.
Nota: El controlador correspondiente es onValueRolePatternChanged.
valueRoleReplaceChanged(string replace)
Esta señal se emite cuando valueRoleReplace cambia a replace.
Nota: El controlador correspondiente es onValueRoleReplaceChanged.
© 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.