ItemModelSurfaceDataProxy QML Type

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

• Lista de todos los miembros, incluyendo los heredados
• ItemModelSurfaceDataProxy es parte de Qt Graphs QML Types for 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 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 Graphs Manejo de datos con 3D.

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 para 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 : enumeration

Define cómo se gestionan las coincidencias múltiples para cada combinación de fila/columna. Por defecto es ItemModelSurfaceDataProxy.MultiMatchBehavior.Last.

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.MultiMatchBehavior.Average.

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.

type : AbstractDataProxy.DataType [read-only]

El tipo de proxy. Uno de los valores de QAbstractDataProxy::DataType.

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 x-position 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 y-position 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 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 z-position 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 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.

Documentación de señales

autoColumnCategoriesChanged(bool enable)

Esta señal se emite cuando autoColumnCategories cambia a enable.

autoRowCategoriesChanged(bool enable)

Esta señal se emite cuando autoRowCategories cambia a enable.

columnCategoriesChanged()

Esta señal se emite cuando cambia columnCategories.

columnRoleChanged(string role)

Esta señal se emite cuando columnRole cambia a role.

columnRolePatternChanged(regExp pattern)

Esta señal se emite cuando columnRolePattern cambia a pattern.

columnRoleReplaceChanged(string replace)

Esta señal se emite cuando columnRoleReplace cambia a replace.

itemModelChanged(model itemModel)

Esta señal se emite cuando itemModel cambia a itemModel.

multiMatchBehaviorChanged(enumeration behavior)

Esta señal se emite cuando multiMatchBehavior cambia a behavior.

rowCategoriesChanged()

Esta señal se emite cuando cambia rowCategories.

rowRoleChanged(string role)

Esta señal se emite cuando rowRole cambia a role.

rowRolePatternChanged(regExp pattern)

Esta señal se emite cuando rowRolePattern cambia a pattern.

rowRoleReplaceChanged(string replace)

Esta señal se emite cuando rowRoleReplace cambia a replace.

useModelCategoriesChanged(bool enable)

Esta señal se emite cuando useModelCategories cambia a enable.

xPosRoleChanged(string role)

Esta señal se emite cuando xPosRole cambia a role.

xPosRolePatternChanged(regExp pattern)

Esta señal se emite cuando xPosRolePattern cambia a pattern.

xPosRoleReplaceChanged(string replace)

Esta señal se emite cuando xPosRoleReplace cambia a replace.

yPosRoleChanged(string role)

Esta señal se emite cuando yPosRole cambia a role.

yPosRolePatternChanged(regExp pattern)

Esta señal se emite cuando yPosRolePattern cambia a pattern.

yPosRoleReplaceChanged(string replace)

Esta señal se emite cuando yPosRoleReplace cambia a replace.

zPosRoleChanged(string role)

Esta señal se emite cuando zPosRole cambia a role.

zPosRolePatternChanged(regExp pattern)

Esta señal se emite cuando zPosRolePattern cambia a pattern.

zPosRoleReplaceChanged(string replace)

Esta señal se emite cuando zPosRoleReplace cambia a replace.