ItemModelSurfaceDataProxy QML Type
Clase proxy para presentar datos en modelos de elementos con Surface3D. Más...
| Import Statement: | import QtGraphs |
| In C++: | QItemModelSurfaceDataProxy |
| Inherits: |
- Lista de todos los miembros, incluidos los miembros heredados
- ItemModelSurfaceDataProxy 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
- rowCategories : list<String>
- rowRole : string
- rowRolePattern : regExp
- rowRoleReplace : string
- type : AbstractDataProxy.DataType
- useModelCategories : bool
- xPosRole : string
- xPosRolePattern : regExp
- xPosRoleReplace : string
- yPosRole : string
- yPosRolePattern : regExp
- yPosRoleReplace : string
- zPosRole : string
- zPosRolePattern : regExp
- zPosRoleReplace : 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)
- rowCategoriesChanged()
- rowRoleChanged(string role)
- rowRolePatternChanged(regExp pattern)
- rowRoleReplaceChanged(string replace)
- useModelCategoriesChanged(bool enable)
- xPosRoleChanged(string role)
- xPosRolePatternChanged(regExp pattern)
- xPosRoleReplaceChanged(string replace)
- yPosRoleChanged(string role)
- yPosRolePatternChanged(regExp pattern)
- yPosRoleReplaceChanged(string replace)
- zPosRoleChanged(string role)
- zPosRolePatternChanged(regExp pattern)
- zPosRoleReplaceChanged(string replace)
Descripción detallada
Este tipo permite utilizar modelos derivados de AbstractItemModel como fuente de datos para Surface3D.
Los datos se resuelven de forma asíncrona cada vez que cambia la asignación o el modelo.
Para las enumeraciones de ItemModelSurfaceDataProxy, consulta QItemModelSurfaceDataProxy::MultiMatchBehavior.
Para obtener más detalles, consulta la documentación de QItemModelSurfaceDataProxy.
Ejemplo de uso:
ItemModelSurfaceDataProxy {
itemModel: model // E.g. a list model defined elsewhere containing population data.
// Mapping model roles to surface series rows, columns, and values.
rowRole: "longitude"
columnRole: "latitude"
valueRole: "pop_density"
}Véase también SurfaceDataProxy y Qt Graphs: «Manejo de datos en 3D».
Documentación de 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. Los valores mínimos y máximos de las columnas proxy también se generan automáticamente a partir de los datos cuando se establece en « true ». 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. Los valores mínimos y máximos de las filas proxy también se generan automáticamente a partir de los datos cuando esta opción se establece en « true ». El valor por defecto es « true ».
columnCategories : list<String>
Las categorías de las columnas de la asignación. Solo se incluyen en la resolución de datos aquellos elementos cuyas funciones 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 elemento que se asigna a la categoría de columna. Además de definir a qué columna pertenecen los datos, el valor indicado por el rol de columna también se establece como el valor de la coordenada X de QSurfaceDataItem cuando se resuelven los datos del modelo, a menos que también se defina un rol de posición X independiente.
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.
Véase también « columnRole » y « columnRoleReplace ».
columnRoleReplace : string
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 de elemento utilizado como fuente de datos para Surface3D.
multiMatchBehavior : enumeration
Define cómo se gestionan las coincidencias múltiples para cada combinación de fila y columna. El valor predeterminado es « ItemModelSurfaceDataProxy.MultiMatchBehavior.Last ».
Por ejemplo, es posible que tengas un modelo de elementos con datos con marca de tiempo tomados a intervalos irregulares y quieras visualizar la posición media de los elementos de datos cada hora mediante un gráfico de superficie. Esto se puede hacer especificando categorías de filas y columnas de modo que cada punto de la superficie represente una hora, y configurando `multiMatchBehavior` en ` ItemModelSurfaceDataProxy.MultiMatchBehavior.Average`.
rowCategories : list<String>
Las categorías de filas de la asignación. Solo se incluyen los elementos con funciones de fila que figuran en esta lista cuando se resuelven los datos. Las filas se ordenan siguiendo el mismo orden que tienen en esta lista.
rowRole : string
El rol de modelo de elemento que se asigna a la categoría de fila. Además de definir a qué fila pertenecen los datos, el valor indicado por el rol de fila también se establece como el valor de la coordenada Z de QSurfaceDataItem cuando se resuelven los datos del modelo, a menos que también se defina un rol de posición Z independiente.
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.
Véase también « rowRole » y « rowRoleReplace ».
rowRoleReplace : string
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. El valor por defecto es « false ».
xPosRole : string
El rol del modelo de elemento que se va a asignar a la posición X. Si no se define este rol, se utiliza « columnRole » para determinar el valor de la coordenada X de los elementos resueltos de « QSurfaceDataItem ».
xPosRolePattern : regExp
Cuando se activa, se realiza una búsqueda y sustitución en el valor asignado por la función de posición x antes de que se utilice como valor de posición de un elemento. Esta propiedad especifica la expresión regular para encontrar la parte del valor asignado que se va a sustituir, y la propiedad « xPosRoleReplace » contiene la cadena de sustitución.
Véase también « xPosRole » y « xPosRoleReplace ».
xPosRoleReplace : string
Contenido de sustitución que se utilizará junto con xPosRolePattern. 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 xPosRole y xPosRolePattern.
yPosRole : string
El rol del modelo del elemento que se va a asignar a la posición Y.
yPosRolePattern : regExp
Cuando se activa, se lleva a cabo una búsqueda y sustitución en el valor asignado por la función de posición y antes de que se utilice como valor de posición de un elemento. Esta propiedad especifica la expresión regular para localizar la parte del valor asignado que se va a sustituir, y la propiedad « yPosRoleReplace » contiene la cadena de sustitución.
Véase también « yPosRole » y « yPosRoleReplace ».
yPosRoleReplace : string
Contenido de sustitución que se utilizará junto con ` yPosRolePattern`. 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 yPosRole y yPosRolePattern.
zPosRole : string
El rol del modelo de elemento que se va a asignar a la posición Z. Si no se define este rol, se utiliza « rowRole » para determinar el valor de la coordenada Z de los elementos resueltos QSurfaceDataItem.
zPosRolePattern : regExp
Cuando se activa, se realiza una búsqueda y sustitución en el valor asignado por la función «z-position» antes de que se utilice como valor de posición del elemento. Esta propiedad especifica la expresión regular para encontrar la parte del valor asignado que se va a sustituir, y la propiedad « zPosRoleReplace » contiene la cadena de sustitución.
Véase también « zPosRole » y « zPosRoleReplace ».
zPosRoleReplace : string
Contenido de sustitución que se utilizará junto con zPosRolePattern. 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 zPosRole y zPosRolePattern.
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.
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.
xPosRoleChanged(string role)
Esta señal se emite cuando xPosRole cambia a role.
Nota: El controlador correspondiente es onXPosRoleChanged.
xPosRolePatternChanged(regExp pattern)
Esta señal se emite cuando xPosRolePattern cambia a pattern.
Nota: El controlador correspondiente es onXPosRolePatternChanged.
xPosRoleReplaceChanged(string replace)
Esta señal se emite cuando xPosRoleReplace cambia a replace.
Nota: El controlador correspondiente es onXPosRoleReplaceChanged.
yPosRoleChanged(string role)
Esta señal se emite cuando yPosRole cambia a role.
Nota: El controlador correspondiente es onYPosRoleChanged.
yPosRolePatternChanged(regExp pattern)
Esta señal se emite cuando yPosRolePattern cambia a pattern.
Nota: El controlador correspondiente es onYPosRolePatternChanged.
yPosRoleReplaceChanged(string replace)
Esta señal se emite cuando yPosRoleReplace cambia a replace.
Nota: El controlador correspondiente es onYPosRoleReplaceChanged.
zPosRoleChanged(string role)
Esta señal se emite cuando zPosRole cambia a role.
Nota: El controlador correspondiente es onZPosRoleChanged.
zPosRolePatternChanged(regExp pattern)
Esta señal se emite cuando zPosRolePattern cambia a pattern.
Nota: El controlador correspondiente es onZPosRolePatternChanged.
zPosRoleReplaceChanged(string replace)
Esta señal se emite cuando zPosRoleReplace cambia a replace.
Nota: El controlador correspondiente es onZPosRoleReplaceChanged.
© 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.