ItemModelBarDataProxy QML Type

Clase proxy para presentar datos en modelos de elementos con Bars3D. 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 : ItemModelBarDataProxy.MultiMatchBehavior
• rotationRole : string
• rotationRolePattern : regExp
• rotationRoleReplace : string
• rowCategories : list<String>
• rowRole : string
• rowRolePattern : regExp
• rowRoleReplace : string
• useModelCategories : bool
• valueRole : string
• valueRolePattern : regExp
• valueRoleReplace : string

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. QBarDataProxy::arrayReset() se emite cuando se han resuelto los datos.

Para los enums ItemModelBarDataProxy, véase QItemModelBarDataProxy::MultiMatchBehavior.

Para más detalles, consulte 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: ["2010", "2011", "2012", "2013"]
    columnCategories: ["Oulu", "Rauma", "Helsinki", "Tampere"]
}

Véase también BarDataProxy y Qt Data Visualization Manejo de datos.

Documentación de propiedades

autoColumnCategories : bool

Cuando se establece en true, la asignación 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. Por defecto es true.

autoRowCategories : bool

Cuando se establece en true, la asignación 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. Por defecto es true.

columnCategories : list<String>

Las categorías de columna de la asignación. Sólo los elementos con valores de rol 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

La función del modelo de artículo que se asignará a la categoría de columna.

columnRolePattern : regExp

Cuando se establece, se realiza una búsqueda y reemplazo en el valor mapeado por rol de columna antes de que se utilice 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. Esto es útil, por ejemplo, para analizar categorías de filas y columnas a partir de un único campo de fecha y hora en el modelo de artículos.

Véase también columnRole y columnRoleReplace.

columnRoleReplace : string

Esta propiedad define el contenido de reemplazo 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.

multiMatchBehavior : ItemModelBarDataProxy.MultiMatchBehavior

Define cómo se manejan las coincidencias múltiples para cada combinación de fila/columna. Por defecto es ItemModelBarDataProxy.MMBLast. El comportamiento elegido afecta tanto al valor de la barra como a la rotación.

Por ejemplo, puede tener un modelo de elementos con datos con marca de tiempo tomados a intervalos irregulares y desea visualizar el valor total de los elementos de datos en cada día con un gráfico de barras. Esto se puede hacer especificando las categorías de fila y columna para que cada barra represente un día, y estableciendo multiMatchBehavior en ItemModelBarDataProxy.MMBCumulative.

rotationRole : string

El rol del modelo de ítem a mapear en el ángulo de rotación de la barra.

rotationRolePattern : regExp

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

Véase también rotationRole y rotationRoleReplace.

rotationRoleReplace : string

Esta propiedad define el contenido de reemplazo que se utilizará junto con rotationRolePattern. 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 rotationRole y rotationRolePattern.

rowCategories : list<String>

Las categorías de fila de la asignación. Sólo los elementos con valores de rol 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

La función del modelo de artículo que se asignará a la categoría de fila.

rowRolePattern : regExp

Cuando se establece, se realiza una búsqueda y sustitución en el valor asignado 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. Esto es útil, por ejemplo, para analizar categorías de filas y columnas a partir de un único campo de fecha y hora en el modelo de artículos.

Véase también rowRole y rowRoleReplace.

rowRoleReplace : string

Esta propiedad define el contenido de reemplazo 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. Las cabeceras de fila y columna se utilizan para las etiquetas de fila y columna. Por defecto es false.

valueRole : string

El rol del modelo de ítem a mapear en valor de barra.

valueRolePattern : regExp

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

Véase también valueRole y valueRoleReplace.

valueRoleReplace : string

Esta propiedad define el contenido de reemplazo que se utilizará junto con valueRolePattern. 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 valueRole y valueRolePattern.