ItemModelSurfaceDataProxy QML Type

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

• Lista de todos los miembros, incluidos los heredados

Propiedades

• autoColumnCategories : bool
• autoRowCategories : bool
• columnCategories : list<String>
• columnRole : string
• columnRolePattern : regExp
• columnRoleReplace : string
• itemModel : model
• multiMatchBehavior : ItemModelSurfaceDataProxy.MultiMatchBehavior
• rowCategories : list<String>
• rowRole : string
• rowRolePattern : regExp
• rowRoleReplace : string
• useModelCategories : bool
• xPosRole : string
• xPosRolePattern : regExp
• xPosRoleReplace : string
• yPosRole : string
• yPosRolePattern : regExp
• yPosRoleReplace : string
• zPosRole : string
• zPosRolePattern : regExp
• zPosRoleReplace : string

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 los enums ItemModelSurfaceDataProxy, véase QItemModelSurfaceDataProxy::MultiMatchBehavior.

Para más detalles, consulte 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 propiedades

autoColumnCategories : bool

Cuando se establece en true, el mapeo ignora cualquier categoría de columna establecida explícitamente y las sobrescribe con las generadas automáticamente cada vez que se resuelven los datos del modelo. Los valores máximos y mínimos aproximados de las columnas también se generan automáticamente a partir de los datos cuando se establece en true. Por defecto es true.

autoRowCategories : bool

Cuando se establece en true, el mapeo ignora cualquier categoría de fila establecida explícitamente y las sobrescribe con las generadas automáticamente cada vez que se resuelven los datos del modelo. Los valores máximos y mínimos aproximados de las filas también se generan automáticamente a partir de los datos cuando se establece en true. Por defecto es true.

columnCategories : list<String>

Las categorías de columna de la asignación. Sólo los elementos con funciones de columna que se encuentran en esta lista se incluyen cuando se resuelven los datos. Las columnas se ordenan en el mismo orden en que aparecen en esta lista.

columnRole : string

El rol de modelo de elemento a asignar 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 establece, se realiza una búsqueda y reemplazo en el valor mapeado por el rol de columna antes de ser utilizado como categoría de columna. Esta propiedad especifica la expresión regular para encontrar la porción del valor mapeado a reemplazar y la propiedad columnRoleReplace contiene la cadena de reemplazo.

Véase también columnRole y columnRoleReplace.

columnRoleReplace : string

El contenido de sustitución que se utilizará junto con columnRolePattern. Por defecto es una cadena vacía. Para más información sobre cómo funciona la búsqueda y sustitución mediante expresiones regulares, consulte 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 artículo 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/columna. Por defecto es ItemModelSurfaceDataProxy.MMBLast.

Por ejemplo, puede tener un modelo de elementos con datos con marca de tiempo tomados a intervalos irregulares y desea visualizar una posición media de los elementos de datos en cada hora con un gráfico de superficie. Esto se puede hacer especificando las categorías de fila y columna para que cada punto de superficie represente una hora, y estableciendo multiMatchBehavior en ItemModelSurfaceDataProxy.MMBAverage.

rowCategories : list<String>

Las categorías de fila de la asignación. Sólo los elementos con funciones de fila que se encuentran en esta lista se incluyen cuando se resuelven los datos. Las filas se ordenan en el mismo orden en que aparecen en esta lista.

rowRole : string

El rol de modelo de elemento a asignar a la categoría de fila. 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 separado z position.

rowRolePattern : regExp

Cuando se establece, se realiza una búsqueda y reemplazo en el valor mapeado por el rol de fila antes de que se utilice como categoría de fila. Esta propiedad especifica la expresión regular para encontrar la porción del valor mapeado a reemplazar y la propiedad rowRoleReplace contiene la cadena de reemplazo.

Véase también rowRole y rowRoleReplace.

rowRoleReplace : string

El contenido de sustitución que se utilizará junto con rowRolePattern. Por defecto es una cadena vacía. Para más información sobre cómo funciona la búsqueda y sustitución mediante expresiones regulares, consulte 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 categorías de filas y columnas, y utiliza en su lugar las filas y columnas del modelo. Por defecto es false.

xPosRole : string

El rol del modelo de elemento 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 establece, se realiza una búsqueda y reemplazo en el valor mapeado por el rol de posición x antes de que se utilice como valor de posición de elemento. Esta propiedad especifica la expresión regular para encontrar la porción del valor mapeado a reemplazar y la propiedad xPosRoleReplace contiene la cadena de reemplazo.

Véase también xPosRole y xPosRoleReplace.

xPosRoleReplace : string

El contenido de sustitución que se utilizará junto con xPosRolePattern. Por defecto es una cadena vacía. Para más información sobre cómo funciona la búsqueda y sustitución mediante expresiones regulares, consulte 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 de artículo a asignar a la posición Y.

yPosRolePattern : regExp

Cuando se establece, se realiza una búsqueda y reemplazo en el valor mapeado por el rol de posición y antes de ser utilizado como valor de posición de elemento. Esta propiedad especifica la expresión regular para encontrar la porción del valor mapeado a reemplazar y la propiedad yPosRoleReplace contiene la cadena de reemplazo.

Véase también yPosRole y yPosRoleReplace.

yPosRoleReplace : string

El contenido de sustitución que se utilizará junto con yPosRolePattern. Por defecto es una cadena vacía. Para más información sobre cómo funciona la búsqueda y sustitución mediante expresiones regulares, consulte 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 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 de QSurfaceDataItem.

zPosRolePattern : regExp

Cuando se establece, se realiza una búsqueda y reemplazo en el valor mapeado por el rol de posición z antes de ser utilizado como valor de posición de elemento. Esta propiedad especifica la expresión regular para encontrar la porción del valor mapeado a reemplazar y la propiedad zPosRoleReplace contiene la cadena de reemplazo.

Véase también zPosRole y zPosRoleReplace.

zPosRoleReplace : string

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

Véase también zPosRole y zPosRolePattern.