ItemModelBarDataProxy QML Type

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

• Lista de todos los miembros, incluyendo los heredados
• ItemModelBarDataProxy 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
• rotationRole : string
• rotationRolePattern : regExp
• rotationRoleReplace : string
• rowCategories : list<String>
• rowRole : string
• rowRolePattern : regExp
• rowRoleReplace : string
• type : AbstractDataProxy.DataType
• useModelCategories : bool
• valueRole : string
• valueRolePattern : regExp
• valueRoleReplace : 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)
• rotationRoleChanged(string role)
• rotationRolePatternChanged(regExp pattern)
• rotationRoleReplaceChanged(string replace)
• rowCategoriesChanged()
• rowRoleChanged(string role)
• rowRolePatternChanged(regExp pattern)
• rowRoleReplaceChanged(string replace)
• useModelCategoriesChanged(bool enable)
• valueRoleChanged(string role)
• valueRolePatternChanged(regExp pattern)
• valueRoleReplaceChanged(string replace)

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: ["2020", "2021", "2022", "2023"]
    columnCategories: ["Oulu", "Rauma", "Helsinki", "Tampere"]
}

Véase también BarDataProxy y Qt Graphs Manipulación de datos con 3D.

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 el 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 sustitución que se utilizará 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, 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 : enumeration

Define cómo se manejan las coincidencias múltiples para cada combinación de fila/columna. Por defecto es ItemModelBarDataProxy.MultiMatchBehavior.Last. 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.MultiMatchBehavior.Cumulative.

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 sustitución que se utilizará junto con rotationRolePattern. 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, 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 sustitución que se utilizará 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, 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. 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 sustitución que se utilizará junto con valueRolePattern. 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, consulte la documentación de la función QString::replace(const QRegularExpression &rx, const QString &after).

Véase también valueRole y valueRolePattern.

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.

rotationRoleChanged(string role)

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

rotationRolePatternChanged(regExp pattern)

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

rotationRoleReplaceChanged(string replace)

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

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.

valueRoleChanged(string role)

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

valueRolePatternChanged(regExp pattern)

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

valueRoleReplaceChanged(string replace)

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