En esta página

ItemModelSurfaceDataProxy QML Type

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

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

SurfaceDataProxy

Status: Deprecated

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

Propiedades

Descripción detallada

Este tipo te 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 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. 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 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 los elementos cuyas funciones de columna figuran en esta lista. Las columnas se ordenan siguiendo el mismo orden que tienen 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 la 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

El contenido que se va a sustituir, que debe utilizarse junto con columnRolePattern. 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 : ItemModelSurfaceDataProxy.MultiMatchBehavior

Define cómo se gestionan las coincidencias múltiples para cada combinación de fila y columna. El valor predeterminado es « ItemModelSurfaceDataProxy.MMBLast ».

Por ejemplo, podría tener un modelo de elementos con datos con marca de tiempo tomados a intervalos irregulares y querer 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.MMBAverage`.

rowCategories : list<String>

Las categorías de filas de la correspondencia. Solo se incluyen en la resolución de datos los elementos cuyos roles de fila figuren en esta lista. Las filas se ordenan siguiendo el mismo orden que tienen en esta lista.

rowRole : string

El rol «item» del modelo se asigna a la categoría «row». Además de definir a qué fila pertenecen los datos, el valor indicado por el rol «row» 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

El contenido que se va a sustituir, que debe utilizarse junto con rowRolePattern. 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 configura 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 lleva a cabo 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 localizar 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

El contenido que se va a sustituir se debe utilizar junto con xPosRolePattern. 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 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 del 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

El contenido que se va a sustituir se debe utilizar junto con ` yPosRolePattern`. 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 yPosRole y yPosRolePattern.

zPosRole : string

El rol del modelo del 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 de posición «z» 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 « zPosRoleReplace » contiene la cadena de sustitución.

Véase también « zPosRole » y « zPosRoleReplace ».

zPosRoleReplace : string

El contenido que se va a sustituir, que debe utilizarse 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.

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