QItemModelBarDataProxy Class

// By defining row and column categories, you tell the mapping which row and column each item
// belongs to. The categories must match the data stored in the model in the roles you define
// for row and column mapping. In this example we expect "year" role to return four digit year
// and "month" to return three letter designation for the month.
//
// An example of an item in model would be:
// Requested role -> Returned data
// "year" -> "2006" // Matches the first row category, so this item is added to the first row.
// "month" -> "jan" // Matches the first column category, so this item is added as first item in the row.
// "income" -> "12.1"
// "expenses" -> "9.2"
QStringList years;
QStringList months;
years << "2006" << "2007" << "2008" << "2009" << "2010" << "2011" << "2012";
months << "jan" << "feb" << "mar" << "apr" << "may" << "jun" << "jul" << "aug" << "sep" << "oct" << "nov" << "dec";

QItemModelBarDataProxy *proxy = new QItemModelBarDataProxy(customModel,
                                                           QStringLiteral("year"), // Row role
                                                           QStringLiteral("month"), // Column role
                                                           QStringLiteral("income"), // Value role
                                                           years, // Row categories
                                                           months); // Column categories

//...

// To display different data later, you can simply change the mapping.
proxy->setValueRole(QStringLiteral("expenses"));

Documentación de propiedades

autoColumnCategories : bool

Esta propiedad indica si las categorías de columna se generan automáticamente.

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.

Funciones de acceso:

Señal de notificador:

autoRowCategories : bool

Esta propiedad indica si las categorías de filas se generan automáticamente.

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.

Funciones de acceso:

Señal de notificador:

columnCategories : QStringList

Esta propiedad contiene las categorías de columna para la asignación.

Funciones de acceso:

Señal del notificador:

columnRole : QString

Esta propiedad contiene el rol de la columna para el mapeo.

Funciones de acceso:

Señal de notificador:

columnRolePattern : QRegularExpression

Esta propiedad indica si se realiza una búsqueda y reemplazo en el valor asignado 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. 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.

Funciones de acceso:

Señal de notificador:

Véase también columnRole y columnRoleReplace.

columnRoleReplace : QString

Esta propiedad contiene 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).

Funciones de acceso:

Señal de notificador:

Véase también columnRole y columnRolePattern.

itemModel : QAbstractItemModel*

Esta propiedad contiene el modelo del artículo.

Funciones de acceso:

Señal del notificador:

multiMatchBehavior : MultiMatchBehavior

Cómo se manejan las coincidencias múltiples para cada combinación de fila/columna.

Por defecto es QItemModelBarDataProxy::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. Para ello, especifique las categorías de filas y columnas de modo que cada barra represente un día y establezca multiMatchBehavior en QItemModelBarDataProxy::MMBCumulative.

Funciones de acceso:

Señal del notificador:

rotationRole : QString

Esta propiedad contiene la función de rotación para la asignación.

Funciones de acceso:

Señal de notificador:

rotationRolePattern : QRegularExpression

Esta propiedad mantiene si 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.

Funciones de acceso:

Señal de notificador:

Véase también rotationRole y rotationRoleReplace.

rotationRoleReplace : QString

Esta propiedad contiene 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).

Funciones de acceso:

Señal de notificador:

Véase también rotationRole y rotationRolePattern.

rowCategories : QStringList

Esta propiedad contiene las categorías de filas para la asignación.

Funciones de acceso:

Señal del notificador:

rowRole : QString

Esta propiedad contiene el rol de fila para la asignación.

Funciones de acceso:

Señal de notificador:

rowRolePattern : QRegularExpression

Esta propiedad indica si se realiza una búsqueda y reemplazo en el valor asignado por el rol de fila antes de utilizarlo 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.

Funciones de acceso:

Señal de notificador:

Véase también rowRole y rowRoleReplace.

rowRoleReplace : QString

Esta propiedad contiene 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).

Funciones de acceso:

Señal de notificador:

Véase también rowRole y rowRolePattern.

useModelCategories : bool

Esta propiedad establece si los roles y categorías de filas y columnas se utilizan para el mapeo.

Cuando se establece a true, el mapeo 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.

Funciones de acceso:

Señal de notificador:

valueRole : QString

Esta propiedad contiene la función de valor para la asignación.

Funciones de acceso:

Señal de notificador:

valueRolePattern : QRegularExpression

Esta propiedad mantiene si se realiza una búsqueda y reemplazo en el valor mapeado por el rol value antes de ser utilizado 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.

Funciones de acceso:

Señal de notificador:

Véase también valueRole y valueRoleReplace.

valueRoleReplace : QString

Esta propiedad contiene 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).

Funciones de acceso:

Señal de notificador:

Véase también valueRole y valueRolePattern.