En esta página

QItemModelBarDataProxy Class

Clase proxy para presentar datos en modelos de elementos con Q3DBars. Más información...

Encabezado: #include <QItemModelBarDataProxy>
CMake: find_package(Qt6 REQUIRED COMPONENTS DataVisualization)
target_link_libraries(mytarget PRIVATE Qt6::DataVisualization)
qmake: QT += datavisualization
Desde: QtDataVisualization 1.0
En QML: ItemModelBarDataProxy
Heredado de: QBarDataProxy
Estado: Obsoleto

Esta clase está obsoleta. Se desaconseja encarecidamente su uso en código nuevo.

Tipos públicos

enum MultiMatchBehavior { MMBFirst, MMBLast, MMBAverage, MMBCumulative }

Propiedades

Funciones públicas

QItemModelBarDataProxy(QObject *parent = nullptr)
QItemModelBarDataProxy(QAbstractItemModel *itemModel, QObject *parent = nullptr)
QItemModelBarDataProxy(QAbstractItemModel *itemModel, const QString &valueRole, QObject *parent = nullptr)
QItemModelBarDataProxy(QAbstractItemModel *itemModel, const QString &rowRole, const QString &columnRole, const QString &valueRole, QObject *parent = nullptr)
QItemModelBarDataProxy(QAbstractItemModel *itemModel, const QString &rowRole, const QString &columnRole, const QString &valueRole, const QString &rotationRole, QObject *parent = nullptr)
QItemModelBarDataProxy(QAbstractItemModel *itemModel, const QString &rowRole, const QString &columnRole, const QString &valueRole, const QStringList &rowCategories, const QStringList &columnCategories, QObject *parent = nullptr)
QItemModelBarDataProxy(QAbstractItemModel *itemModel, const QString &rowRole, const QString &columnRole, const QString &valueRole, const QString &rotationRole, const QStringList &rowCategories, const QStringList &columnCategories, QObject *parent = nullptr)
virtual ~QItemModelBarDataProxy()
bool autoColumnCategories() const
bool autoRowCategories() const
QStringList columnCategories() const
int columnCategoryIndex(const QString &category)
QString columnRole() const
QRegularExpression columnRolePattern() const
QString columnRoleReplace() const
QAbstractItemModel *itemModel() const
QItemModelBarDataProxy::MultiMatchBehavior multiMatchBehavior() const
void remap(const QString &rowRole, const QString &columnRole, const QString &valueRole, const QString &rotationRole, const QStringList &rowCategories, const QStringList &columnCategories)
QString rotationRole() const
QRegularExpression rotationRolePattern() const
QString rotationRoleReplace() const
QStringList rowCategories() const
int rowCategoryIndex(const QString &category)
QString rowRole() const
QRegularExpression rowRolePattern() const
QString rowRoleReplace() const
void setAutoColumnCategories(bool enable)
void setAutoRowCategories(bool enable)
void setColumnCategories(const QStringList &categories)
void setColumnRole(const QString &role)
void setColumnRolePattern(const QRegularExpression &pattern)
void setColumnRoleReplace(const QString &replace)
void setItemModel(QAbstractItemModel *itemModel)
void setMultiMatchBehavior(QItemModelBarDataProxy::MultiMatchBehavior behavior)
void setRotationRole(const QString &role)
void setRotationRolePattern(const QRegularExpression &pattern)
void setRotationRoleReplace(const QString &replace)
void setRowCategories(const QStringList &categories)
void setRowRole(const QString &role)
void setRowRolePattern(const QRegularExpression &pattern)
void setRowRoleReplace(const QString &replace)
void setUseModelCategories(bool enable)
void setValueRole(const QString &role)
void setValueRolePattern(const QRegularExpression &pattern)
void setValueRoleReplace(const QString &replace)
bool useModelCategories() const
QString valueRole() const
QRegularExpression valueRolePattern() const
QString valueRoleReplace() const

Señales

void autoColumnCategoriesChanged(bool enable)
void autoRowCategoriesChanged(bool enable)
void columnCategoriesChanged()
void columnRoleChanged(const QString &role)
void columnRolePatternChanged(const QRegularExpression &pattern)
void columnRoleReplaceChanged(const QString &replace)
void itemModelChanged(const QAbstractItemModel *itemModel)
void multiMatchBehaviorChanged(QItemModelBarDataProxy::MultiMatchBehavior behavior)
void rotationRoleChanged(const QString &role)
void rotationRolePatternChanged(const QRegularExpression &pattern)
void rotationRoleReplaceChanged(const QString &replace)
void rowCategoriesChanged()
void rowRoleChanged(const QString &role)
void rowRolePatternChanged(const QRegularExpression &pattern)
void rowRoleReplaceChanged(const QString &replace)
void useModelCategoriesChanged(bool enable)
void valueRoleChanged(const QString &role)
void valueRolePatternChanged(const QRegularExpression &pattern)
void valueRoleReplaceChanged(const QString &replace)

Descripción detallada

QItemModelBarDataProxy permite utilizar modelos derivados de QAbstractItemModel como fuente de datos para Q3DBars. Utiliza las asignaciones definidas para mapear los datos del modelo a filas, columnas y valores de un gráfico de Q3DBars.

Los datos se resuelven de forma asíncrona cada vez que cambian las asignaciones o el modelo. Se emite QBarDataProxy::arrayReset() cuando se han resuelto los datos. Sin embargo, cuando la propiedad useModelCategories está establecida en «true», los cambios en un único elemento se resuelven de forma síncrona, a menos que el mismo fotograma contenga también un cambio que provoque la resolución de todo el modelo.

Las asignaciones se pueden utilizar de las siguientes formas:

  • Si la propiedad ` useModelCategories ` se establece en `true`, este proxy asignará las filas y columnas de ` QAbstractItemModel ` directamente a las filas y columnas de ` Q3DBars`, y utilizará por defecto el valor devuelto por ` Qt::DisplayRole ` como valor de la barra. La función del valor que se va a utilizar se puede redefinir si ` Qt::DisplayRole ` no resulta adecuado.
  • En el caso de los modelos cuyos datos no estén ya ordenados claramente en filas y columnas, como los modelos basados en QAbstractListModel, se puede definir una función desde el modelo para asignar cada una de las filas, columnas y valores.
  • Si no deseas incluir todos los datos contenidos en el modelo, o si las filas y columnas generadas automáticamente no están ordenadas como deseas, puedes especificar qué filas y columnas deben incluirse y en qué orden definiendo una lista explícita de categorías para las filas, las columnas o ambas.

Por ejemplo, supongamos que dispone de un modelo personalizado de « QAbstractItemModel » para almacenar diversos valores mensuales relacionados con una empresa. Cada elemento del modelo tiene las funciones «año», «mes», «ingresos» y «gastos». Podría hacer lo siguiente para mostrar los datos en un gráfico de barras:

// 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"));

Si los campos del modelo no contienen los datos en el formato exacto que necesitas, puedes especificar una expresión regular de búsqueda y una regla de sustitución para cada rol, con el fin de obtener el valor en el formato que necesites. Para obtener más información sobre cómo funciona la sustitución mediante expresiones regulares, consulta la documentación de la función ` QString::replace` (`const QRegularExpression &rx, const QString &after)`. Ten en cuenta que el uso de expresiones regulares afecta al rendimiento, por lo que resulta más eficiente utilizar modelos de elementos en los que no sea necesario realizar búsquedas ni sustituciones para obtener los valores deseados.

Por ejemplo, para saber cómo utilizar los patrones de búsqueda junto con los roles, consulta el ejemplo «Gráfico de barras sencillo ».

Véase también «Manejo de datos»en Qt Data Visualization .

Documentación sobre los tipos de miembro

enum QItemModelBarDataProxy::MultiMatchBehavior

Tipos de comportamiento para la propiedad « QItemModelBarDataProxy::multiMatchBehavior ».

ConstanteValorDescripción
QItemModelBarDataProxy::MMBFirst0El valor se toma del primer elemento del modelo de elementos que coincide con cada combinación de fila y columna.
QItemModelBarDataProxy::MMBLast1El valor se toma del último elemento del modelo de elementos que coincide con cada combinación de fila y columna.
QItemModelBarDataProxy::MMBAverage2Se calcula la media de los valores de todos los elementos que coinciden con cada combinación de fila y columna, y se utiliza dicha media como valor de la barra.
QItemModelBarDataProxy::MMBCumulative3Se suman los valores de todos los elementos que coinciden con cada combinación de fila y columna, y el total se utiliza como valor de la barra.

Documentación de la propiedad

autoColumnCategories : bool

Esta propiedad determina si las categorías de las columnas 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. El valor por defecto es « true ».

Funciones de acceso:

bool autoColumnCategories() const
void setAutoColumnCategories(bool enable)

Señal de notificación:

void autoColumnCategoriesChanged(bool enable)

autoRowCategories : bool

Esta propiedad determina 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 otras generadas automáticamente cada vez que se resuelven los datos del modelo. El valor por defecto es « true ».

Funciones de acceso:

bool autoRowCategories() const
void setAutoRowCategories(bool enable)

Señal de notificación:

void autoRowCategoriesChanged(bool enable)

columnCategories : QStringList

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

Funciones de acceso:

QStringList columnCategories() const
void setColumnCategories(const QStringList &categories)

Señal de notificador:

void columnCategoriesChanged()

columnRole : QString

Esta propiedad define la función de la columna en la asignación.

Funciones de acceso:

QString columnRole() const
void setColumnRole(const QString &role)

Señal de notificación:

void columnRoleChanged(const QString &role)

columnRolePattern : QRegularExpression

Esta propiedad indica si se realiza una búsqueda y sustitución en el valor asignado por la función de columna antes de que se utilice como categoría de columna.

Esta propiedad especifica la expresión regular para encontrar la parte del valor asignado que se va a sustituir, y la propiedad « columnRoleReplace » contiene la cadena de sustitución. Esto resulta útil, por ejemplo, para analizar las categorías de filas y columnas a partir de un único campo de marca de tiempo en el modelo de elemento.

Funciones de acceso:

QRegularExpression columnRolePattern() const
void setColumnRolePattern(const QRegularExpression &pattern)

Señal de notificador:

void columnRolePatternChanged(const QRegularExpression &pattern)

Véase también « columnRole » y « columnRoleReplace ».

columnRoleReplace : QString

Esta propiedad contiene el contenido de sustitución que se utilizará junto con columnRolePattern.

El valor 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, consulta la documentación de la función QString::replace(const QRegularExpression &rx, const QString &after).

Funciones de acceso:

QString columnRoleReplace() const
void setColumnRoleReplace(const QString &replace)

Señal de notificador:

void columnRoleReplaceChanged(const QString &replace)

Véase también columnRole y columnRolePattern.

itemModel : QAbstractItemModel*

Esta propiedad contiene el modelo del elemento.

Funciones de acceso:

QAbstractItemModel *itemModel() const
void setItemModel(QAbstractItemModel *itemModel)

Señal de notificador:

void itemModelChanged(const QAbstractItemModel *itemModel)

multiMatchBehavior : MultiMatchBehavior

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

El valor por defecto es « QItemModelBarDataProxy::MMBLast ». El comportamiento elegido afecta tanto al valor de las barras como a su rotación.

Por ejemplo, es posible que tengas un modelo de elementos con datos con marca de tiempo tomados a intervalos irregulares y quieras visualizar el valor total de los elementos de datos de cada día mediante un gráfico de barras. Esto se puede hacer especificando categorías de filas y columnas de modo que cada barra represente un día, y configurando multiMatchBehavior en « QItemModelBarDataProxy::MMBCumulative ».

Funciones de acceso:

QItemModelBarDataProxy::MultiMatchBehavior multiMatchBehavior() const
void setMultiMatchBehavior(QItemModelBarDataProxy::MultiMatchBehavior behavior)

Señal de notificador:

void multiMatchBehaviorChanged(QItemModelBarDataProxy::MultiMatchBehavior behavior)

rotationRole : QString

Esta propiedad define la rotación de la correspondencia.

Funciones de acceso:

QString rotationRole() const
void setRotationRole(const QString &role)

Señal de notificación:

void rotationRoleChanged(const QString &role)

rotationRolePattern : QRegularExpression

Esta propiedad indica si se realiza una búsqueda y sustitución en el valor asignado por la función de rotación antes de que se utilice como ángulo de rotación de la barra.

Esta propiedad especifica la expresión regular para localizar la parte del valor asignado que se va a sustituir, y la propiedad « rotationRoleReplace » contiene la cadena de sustitución.

Funciones de acceso:

QRegularExpression rotationRolePattern() const
void setRotationRolePattern(const QRegularExpression &pattern)

Señal de notificación:

void rotationRolePatternChanged(const QRegularExpression &pattern)

Véase también « rotationRole » y « rotationRoleReplace ».

rotationRoleReplace : QString

Esta propiedad contiene el contenido de sustitución que se utilizará junto con rotationRolePattern.

El valor 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, consulta la documentación de la función QString::replace(const QRegularExpression &rx, const QString &after).

Funciones de acceso:

QString rotationRoleReplace() const
void setRotationRoleReplace(const QString &replace)

Señal de notificador:

void rotationRoleReplaceChanged(const QString &replace)

Véase también rotationRole y rotationRolePattern.

rowCategories : QStringList

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

Funciones de acceso:

QStringList rowCategories() const
void setRowCategories(const QStringList &categories)

Señal de notificación:

void rowCategoriesChanged()

rowRole : QString

Esta propiedad desempeña la función de fila en la asignación.

Funciones de acceso:

QString rowRole() const
void setRowRole(const QString &role)

Señal de notificación:

void rowRoleChanged(const QString &role)

rowRolePattern : QRegularExpression

Esta propiedad indica si se lleva a cabo una búsqueda y sustitución en el valor asignado por la función de fila antes de que se utilice como categoría de fila.

Esta propiedad especifica la expresión regular para localizar la parte del valor asignado que se va a sustituir, y la propiedad « rowRoleReplace » contiene la cadena de sustitución. Esto resulta útil, por ejemplo, para analizar las categorías de filas y columnas a partir de un único campo de marca de tiempo en el modelo de elemento.

Funciones de acceso:

QRegularExpression rowRolePattern() const
void setRowRolePattern(const QRegularExpression &pattern)

Señal de notificación:

void rowRolePatternChanged(const QRegularExpression &pattern)

Véase también « rowRole » y « rowRoleReplace ».

rowRoleReplace : QString

Esta propiedad contiene el contenido de sustitución que se utilizará junto con rowRolePattern.

El valor predeterminado es una cadena vacía. Para obtener más información sobre cómo funciona la búsqueda y sustitución mediante expresiones regulares, consulta la documentación de la función QString::replace(const QRegularExpression &rx, const QString &after).

Funciones de acceso:

QString rowRoleReplace() const
void setRowRoleReplace(const QString &replace)

Señal de notificador:

void rowRoleReplaceChanged(const QString &replace)

Véase también rowRole y rowRolePattern.

useModelCategories : bool

Esta propiedad se aplica independientemente de si se utilizan los roles y las categorías de filas y columnas para la asignación.

Cuando se establece en « true », la asignación ignora los roles y las categorías de filas y columnas, y utiliza en su lugar las filas y columnas del modelo. El valor por defecto es « false ».

Funciones de acceso:

bool useModelCategories() const
void setUseModelCategories(bool enable)

Señal de notificación:

void useModelCategoriesChanged(bool enable)

valueRole : QString

Esta propiedad define el papel del valor en la correspondencia.

Funciones de acceso:

QString valueRole() const
void setValueRole(const QString &role)

Señal de notificación:

void valueRoleChanged(const QString &role)

valueRolePattern : QRegularExpression

Esta propiedad indica si se lleva a cabo una búsqueda y sustitución en el valor asignado por la función «valor» antes de que se utilice como valor de barra.

Esta propiedad especifica la expresión regular para localizar la parte del valor asignado que se va a sustituir, y la propiedad « valueRoleReplace » contiene la cadena de sustitución.

Funciones de acceso:

QRegularExpression valueRolePattern() const
void setValueRolePattern(const QRegularExpression &pattern)

Señal de notificación:

void valueRolePatternChanged(const QRegularExpression &pattern)

Véase también « valueRole » y « valueRoleReplace ».

valueRoleReplace : QString

Esta propiedad contiene el contenido de sustitución que se utilizará junto con valueRolePattern.

El valor 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, consulta la documentación de la función QString::replace(const QRegularExpression &rx, const QString &after).

Funciones de acceso:

QString valueRoleReplace() const
void setValueRoleReplace(const QString &replace)

Señal de notificador:

void valueRoleReplaceChanged(const QString &replace)

Véase también valueRole y valueRolePattern.

Documentación de funciones miembro

[explicit] QItemModelBarDataProxy::QItemModelBarDataProxy(QObject *parent = nullptr)

Crea un objeto `QItemModelBarDataProxy` con un ` parent` opcional.

[explicit] QItemModelBarDataProxy::QItemModelBarDataProxy(QAbstractItemModel *itemModel, QObject *parent = nullptr)

Crea un objeto `QItemModelBarDataProxy` con un ` itemModel ` y, opcionalmente, un ` parent`. El proxy no asume la propiedad del ` itemModel`, ya que, por lo general, los modelos de elemento son propiedad de otros controles.

[explicit] QItemModelBarDataProxy::QItemModelBarDataProxy(QAbstractItemModel *itemModel, const QString &valueRole, QObject *parent = nullptr)

Crea un objeto `QItemModelBarDataProxy` con ` itemModel ` y, opcionalmente, ` parent`. El proxy no asume la propiedad de ` itemModel`, ya que, por lo general, los modelos de elemento son propiedad de otros controles. La función de valor se establece en ` valueRole`. Este constructor está pensado para utilizarse con modelos cuyos datos ya estén correctamente ordenados en filas y columnas, por lo que también establece la propiedad ` useModelCategories ` en `true`.

[explicit] QItemModelBarDataProxy::QItemModelBarDataProxy(QAbstractItemModel *itemModel, const QString &rowRole, const QString &columnRole, const QString &valueRole, QObject *parent = nullptr)

Crea un objeto `QItemModelBarDataProxy` con ` itemModel ` y, opcionalmente, ` parent`. El proxy no asume la propiedad de ` itemModel`, ya que, por lo general, los modelos de elemento son propiedad de otros controles. Las asignaciones de roles se establecen mediante ` rowRole`, ` columnRole` y ` valueRole`.

[explicit] QItemModelBarDataProxy::QItemModelBarDataProxy(QAbstractItemModel *itemModel, const QString &rowRole, const QString &columnRole, const QString &valueRole, const QString &rotationRole, QObject *parent = nullptr)

Crea un objeto `QItemModelBarDataProxy` con ` itemModel ` y, opcionalmente, ` parent`. El proxy no asume la propiedad de ` itemModel`, ya que, por lo general, los modelos de elemento son propiedad de otros controles. Las asignaciones de roles se establecen mediante ` rowRole`, ` columnRole`, ` valueRole` y ` rotationRole`.

[explicit] QItemModelBarDataProxy::QItemModelBarDataProxy(QAbstractItemModel *itemModel, const QString &rowRole, const QString &columnRole, const QString &valueRole, const QStringList &rowCategories, const QStringList &columnCategories, QObject *parent = nullptr)

Crea un objeto `QItemModelBarDataProxy` con ` itemModel ` y, opcionalmente, ` parent`. El proxy no asume la propiedad de ` itemModel`, ya que, por lo general, los modelos de elemento son propiedad de otros controles. Las asignaciones de roles se establecen con ` rowRole`, ` columnRole` y ` valueRole`. Las categorías de filas y columnas se establecen con ` rowCategories ` y ` columnCategories`. Este constructor también establece ` autoRowCategories ` y ` autoColumnCategories ` en «false».

[explicit] QItemModelBarDataProxy::QItemModelBarDataProxy(QAbstractItemModel *itemModel, const QString &rowRole, const QString &columnRole, const QString &valueRole, const QString &rotationRole, const QStringList &rowCategories, const QStringList &columnCategories, QObject *parent = nullptr)

Crea un objeto `QItemModelBarDataProxy` con ` itemModel ` y, opcionalmente, ` parent`. El proxy no asume la propiedad de ` itemModel`, ya que, por lo general, los modelos de elemento son propiedad de otros controles. Las asignaciones de roles se establecen con ` rowRole`, ` columnRole`, ` valueRole` y ` rotationRole`. Las categorías de filas y columnas se establecen con ` rowCategories ` y ` columnCategories`. Este constructor también establece ` autoRowCategories ` y ` autoColumnCategories ` en «false».

[virtual noexcept] QItemModelBarDataProxy::~QItemModelBarDataProxy()

Destruye « QItemModelBarDataProxy ».

[invokable] int QItemModelBarDataProxy::columnCategoryIndex(const QString &category)

Devuelve el índice de la categoría especificada « category » en la lista de categorías de columnas. Si no se encuentra la categoría, se devuelve -1.

Nota: Si se está utilizando la generación automática de categorías de columnas, este método no devolverá un índice válido hasta que los datos del modelo se hayan resuelto por primera vez.

Nota: Esta función se puede invocar a través del sistema de metaobjetos y desde QML. Véase Q_INVOKABLE.

void QItemModelBarDataProxy::remap(const QString &rowRole, const QString &columnRole, const QString &valueRole, const QString &rotationRole, const QStringList &rowCategories, const QStringList &columnCategories)

Cambios en rowRole, columnRole, valueRole, rotationRole, rowCategories y columnCategories en la asignación.

[invokable] int QItemModelBarDataProxy::rowCategoryIndex(const QString &category)

Devuelve el índice del « category » especificado en la lista de categorías de filas. Si la lista de categorías de filas está vacía, se devuelve -1.

Nota: Si se está utilizando la generación automática de categorías de filas, este método no devolverá un índice válido hasta que los datos del modelo se hayan resuelto por primera vez.

Nota: Esta función se puede invocar a través del sistema de metaoobjetos y desde QML. Véase ` Q_INVOKABLE`.

void QItemModelBarDataProxy::setItemModel(QAbstractItemModel *itemModel)

Establece el modelo del elemento en itemModel. No asume la propiedad del modelo, pero se conecta a él para detectar cambios.

Nota: Funciónde asignación para la propiedad itemModel.

Véase también itemModel().

© 2026 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.