En esta página

QItemModelSurfaceDataProxy Class

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

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

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

Tipos públicos

enum MultiMatchBehavior { MMBFirst, MMBLast, MMBAverage, MMBCumulativeY }

Propiedades

Funciones públicas

QItemModelSurfaceDataProxy(QObject *parent = nullptr)
QItemModelSurfaceDataProxy(QAbstractItemModel *itemModel, QObject *parent = nullptr)
QItemModelSurfaceDataProxy(QAbstractItemModel *itemModel, const QString &yPosRole, QObject *parent = nullptr)
QItemModelSurfaceDataProxy(QAbstractItemModel *itemModel, const QString &rowRole, const QString &columnRole, const QString &yPosRole, QObject *parent = nullptr)
QItemModelSurfaceDataProxy(QAbstractItemModel *itemModel, const QString &rowRole, const QString &columnRole, const QString &xPosRole, const QString &yPosRole, const QString &zPosRole, QObject *parent = nullptr)
QItemModelSurfaceDataProxy(QAbstractItemModel *itemModel, const QString &rowRole, const QString &columnRole, const QString &yPosRole, const QStringList &rowCategories, const QStringList &columnCategories, QObject *parent = nullptr)
QItemModelSurfaceDataProxy(QAbstractItemModel *itemModel, const QString &rowRole, const QString &columnRole, const QString &xPosRole, const QString &yPosRole, const QString &zPosRole, const QStringList &rowCategories, const QStringList &columnCategories, QObject *parent = nullptr)
virtual ~QItemModelSurfaceDataProxy()
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
QItemModelSurfaceDataProxy::MultiMatchBehavior multiMatchBehavior() const
void remap(const QString &rowRole, const QString &columnRole, const QString &xPosRole, const QString &yPosRole, const QString &zPosRole, const QStringList &rowCategories, const QStringList &columnCategories)
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(QItemModelSurfaceDataProxy::MultiMatchBehavior behavior)
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 setXPosRole(const QString &role)
void setXPosRolePattern(const QRegularExpression &pattern)
void setXPosRoleReplace(const QString &replace)
void setYPosRole(const QString &role)
void setYPosRolePattern(const QRegularExpression &pattern)
void setYPosRoleReplace(const QString &replace)
void setZPosRole(const QString &role)
void setZPosRolePattern(const QRegularExpression &pattern)
void setZPosRoleReplace(const QString &replace)
bool useModelCategories() const
QString xPosRole() const
QRegularExpression xPosRolePattern() const
QString xPosRoleReplace() const
QString yPosRole() const
QRegularExpression yPosRolePattern() const
QString yPosRoleReplace() const
QString zPosRole() const
QRegularExpression zPosRolePattern() const
QString zPosRoleReplace() 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(QItemModelSurfaceDataProxy::MultiMatchBehavior behavior)
void rowCategoriesChanged()
void rowRoleChanged(const QString &role)
void rowRolePatternChanged(const QRegularExpression &pattern)
void rowRoleReplaceChanged(const QString &replace)
void useModelCategoriesChanged(bool enable)
void xPosRoleChanged(const QString &role)
void xPosRolePatternChanged(const QRegularExpression &pattern)
void xPosRoleReplaceChanged(const QString &replace)
void yPosRoleChanged(const QString &role)
void yPosRolePatternChanged(const QRegularExpression &pattern)
void yPosRoleReplaceChanged(const QString &replace)
void zPosRoleChanged(const QString &role)
void zPosRolePatternChanged(const QRegularExpression &pattern)
void zPosRoleReplaceChanged(const QString &replace)

Descripción detallada

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

Los datos se resuelven de forma asíncrona cada vez que cambia la asignación o el modelo. Se emite QSurfaceDataProxy::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 ` a las filas y columnas de ` Q3DSurface`, y utilizará por defecto el valor devuelto por ` Qt::DisplayRole ` como posición Y. Los encabezados de fila y columna se utilizan por defecto para la posición Z y la posición X, si pueden convertirse a números flotantes. De lo contrario, se utilizan los índices de fila y columna. La función de posición Y que se va a utilizar se puede redefinir si Qt::DisplayRole no resulta adecuada. Las funciones de posición Z y X que se van a utilizar se pueden redefinir si los encabezados o los índices no resultan adecuados.
  • En el caso de modelos cuyos datos no estén ya ordenados de forma clara en filas y columnas, como los modelos basados en « QAbstractListModel », puedes definir una función del modelo para asignar cada una de las posiciones de fila, columna y Y.
  • Si no desea incluir todos los datos contenidos en el modelo, o si las filas y columnas generadas automáticamente no están ordenadas como desea, puede 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 « QAbstractItemModel » personalizado que almacena datos de topografía de superficie. Cada elemento del modelo tiene los roles «longitud», «latitud» y «altura». El modelo de elementos ya contiene los datos ordenados correctamente, de modo que las longitudes y latitudes aparecen primero en el orden correcto, lo que nos permite utilizar la generación automática de categorías de filas y columnas. Podrías hacer lo siguiente para mostrar los datos en un gráfico de superficie:

QItemModelSurfaceDataProxy *proxy = new QItemModelSurfaceDataProxy(customModel,
                                                                   QStringLiteral("longitude"), // Row role
                                                                   QStringLiteral("latitude"), // Column role
                                                                   QStringLiteral("height")); // Y-position role

Si los campos del modelo no contienen los datos en el formato exacto que necesitas, puedes especificar una expresión regular de patrón 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 conocer el uso de los patrones de búsqueda junto con los roles, consulta ItemModelBarDataProxy en el ejemplo «Gráfico de barras sencillo ».

Véase también «Qt Data Visualization: manejo de datos».

Documentación sobre los tipos de miembros

enum QItemModelSurfaceDataProxy::MultiMatchBehavior

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

ConstanteValorDescripción
QItemModelSurfaceDataProxy::MMBFirst0Los valores de posición se toman del primer elemento del modelo de elementos que coincide con cada combinación de fila y columna.
QItemModelSurfaceDataProxy::MMBLast1Los valores de posición se toman del último elemento del modelo de elementos que coincide con cada combinación de fila y columna.
QItemModelSurfaceDataProxy::MMBAverage2Se calcula la media de los valores de posición de todos los elementos que coinciden con cada combinación de fila y columna, y se utilizan esas medias como posición del punto de la superficie.
QItemModelSurfaceDataProxy::MMBCumulativeY3Para los valores de X y Z, esto funciona igual que « MMBAverage », pero los valores de Y se suman en lugar de promediarse, y el total se utiliza como posición Y del punto de la superficie.

Documentación de propiedades

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 notificador:

void autoColumnCategoriesChanged(bool enable)

autoRowCategories : bool

Esta propiedad determina si las categorías de fila 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. El valor predeterminado 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 notificación:

void columnCategoriesChanged()

columnRole : QString

Esta propiedad define la función del modelo del elemento que se asignará a la categoría de columna.

Además de definir a qué columna pertenecen los datos, el valor indicado por la función 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 una función de posición X independiente.

Funciones de acceso:

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

Señal del notificador:

void columnRoleChanged(const QString &role)

columnRolePattern : QRegularExpression

Esta propiedad determina 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 localizar la parte del valor asignado que se va a sustituir, y la propiedad « columnRoleReplace » contiene la cadena de sustitución.

Funciones de acceso:

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

Señal de notificación:

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 un patrón de función de columna.

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 del notificador:

void columnRoleReplaceChanged(const QString &replace)

Véase también columnRole y columnRolePattern.

itemModel : QAbstractItemModel*

Esta propiedad contiene el modelo del elemento que se utiliza como fuente de datos para la superficie 3D.

Funciones de acceso:

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

Señal de notificación:

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 « MMBLast ».

Por ejemplo, es posible que tengas un modelo de elementos con datos con marca de tiempo tomados a intervalos irregulares y quieras visualizar la posición media de los elementos de datos cada hora mediante un gráfico de superficie. Esto se puede hacer especificando categorías de filas y columnas de modo que cada punto de la superficie represente una hora, y estableciendo esta propiedad en ` MMBAverage`.

Funciones de acceso:

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

Señal del notificador:

void multiMatchBehaviorChanged(QItemModelSurfaceDataProxy::MultiMatchBehavior behavior)

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 contiene el rol del modelo del elemento que se va a asignar a la categoría de fila.

Además de definir a qué fila pertenecen los datos, el valor indicado por el rol de fila 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 de posición Z independiente.

Funciones de acceso:

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

Señal del notificador:

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 el rol 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.

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 el patrón de rol de fila.

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 rowRoleReplace() const
void setRowRoleReplace(const QString &replace)

Señal de notificación:

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 notificador:

void useModelCategoriesChanged(bool enable)

xPosRole : QString

Esta propiedad desempeña la función de modelo de elemento para asignar la posición X.

Si no se define este rol, se utiliza « columnRole » para determinar el valor de la coordenada X de los objetos resueltos de « QSurfaceDataItem ».

Funciones de acceso:

QString xPosRole() const
void setXPosRole(const QString &role)

Señal del notificador:

void xPosRoleChanged(const QString &role)

xPosRolePattern : QRegularExpression

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

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

Funciones de acceso:

QRegularExpression xPosRolePattern() const
void setXPosRolePattern(const QRegularExpression &pattern)

Señal del notificador:

void xPosRolePatternChanged(const QRegularExpression &pattern)

Véase también « xPosRole » y « xPosRoleReplace ».

xPosRoleReplace : QString

Esta propiedad contiene el contenido de sustitución que se utilizará junto con un patrón de rol de posición x.

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 xPosRoleReplace() const
void setXPosRoleReplace(const QString &replace)

Señal de notificador:

void xPosRoleReplaceChanged(const QString &replace)

Véase también xPosRole y xPosRolePattern.

yPosRole : QString

Esta propiedad desempeña la función de modelo de elemento para asignar la posición Y.

Funciones de acceso:

QString yPosRole() const
void setYPosRole(const QString &role)

Señal de notificación:

void yPosRoleChanged(const QString &role)

yPosRolePattern : QRegularExpression

Esta propiedad indica si se realiza una búsqueda y sustitución en el valor asignado por la función de posición «y» antes de que se utilice como valor de posición de un elemento.

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

Funciones de acceso:

QRegularExpression yPosRolePattern() const
void setYPosRolePattern(const QRegularExpression &pattern)

Señal de notificador:

void yPosRolePatternChanged(const QRegularExpression &pattern)

Véase también « yPosRole » y « yPosRoleReplace ».

yPosRoleReplace : QString

Esta propiedad contiene el contenido de sustitución que se utilizará junto con un patrón de rol de posición «y».

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 yPosRoleReplace() const
void setYPosRoleReplace(const QString &replace)

Señal del notificador:

void yPosRoleReplaceChanged(const QString &replace)

Véase también yPosRole y yPosRolePattern.

zPosRole : QString

Esta propiedad contiene el rol del modelo del elemento que se va 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 objetos resueltos de « QSurfaceDataItem ».

Funciones de acceso:

QString zPosRole() const
void setZPosRole(const QString &role)

Señal de notificación:

void zPosRoleChanged(const QString &role)

zPosRolePattern : QRegularExpression

Esta propiedad indica si se realiza una búsqueda y sustitución en el valor asignado por la función de posición «z» antes de que se utilice como valor de posición de un elemento.

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

Funciones de acceso:

QRegularExpression zPosRolePattern() const
void setZPosRolePattern(const QRegularExpression &pattern)

Señal del notificador:

void zPosRolePatternChanged(const QRegularExpression &pattern)

Véase también « zPosRole » y « zPosRoleReplace ».

zPosRoleReplace : QString

Esta propiedad contiene el contenido de sustitución que se utilizará junto con un patrón de posición «z».

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 zPosRoleReplace() const
void setZPosRoleReplace(const QString &replace)

Señal de notificador:

void zPosRoleReplaceChanged(const QString &replace)

Véase también zPosRole y zPosRolePattern.

Documentación de la función miembro

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

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

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

Crea un objeto `QItemModelSurfaceDataProxy` 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.

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

Crea un objeto `QItemModelSurfaceDataProxy` con ` itemModel ` y, opcionalmente, ` parent`. El proxy no asume la propiedad de ` itemModel`, ya que, por lo general, los modelos de elementos son propiedad de otros controles. La función ` yPosRole ` se establece en ` yPosRole`. 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] QItemModelSurfaceDataProxy::QItemModelSurfaceDataProxy(QAbstractItemModel *itemModel, const QString &rowRole, const QString &columnRole, const QString &yPosRole, QObject *parent = nullptr)

Crea un objeto `QItemModelSurfaceDataProxy` 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 ` yPosRole`. Los valores de ` zPosRole ` y ` xPosRole ` se establecen en ` rowRole ` y ` columnRole`, respectivamente.

[explicit] QItemModelSurfaceDataProxy::QItemModelSurfaceDataProxy(QAbstractItemModel *itemModel, const QString &rowRole, const QString &columnRole, const QString &xPosRole, const QString &yPosRole, const QString &zPosRole, QObject *parent = nullptr)

Crea un objeto `QItemModelSurfaceDataProxy` 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`, ` xPosRole`, ` yPosRole` y ` zPosRole`.

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

Crea un objeto `QItemModelSurfaceDataProxy` 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 ` yPosRole`. Las propiedades ` zPosRole ` y ` xPosRole ` se establecen en ` rowRole ` y ` columnRole`, respectivamente. Las categorías de filas y columnas se establecen con ` rowCategories ` y ` columnCategories`. Este constructor también establece ` autoRowCategories ` y ` autoColumnCategories ` en `false`.

[explicit] QItemModelSurfaceDataProxy::QItemModelSurfaceDataProxy(QAbstractItemModel *itemModel, const QString &rowRole, const QString &columnRole, const QString &xPosRole, const QString &yPosRole, const QString &zPosRole, const QStringList &rowCategories, const QStringList &columnCategories, QObject *parent = nullptr)

Crea un objeto `QItemModelSurfaceDataProxy` 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`, ` xPosRole`, ` yPosRole` y ` zPosRole`. 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] QItemModelSurfaceDataProxy::~QItemModelSurfaceDataProxy()

Destruye « QItemModelSurfaceDataProxy ».

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

Devuelve el índice de la « category » especificada 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 QItemModelSurfaceDataProxy::remap(const QString &rowRole, const QString &columnRole, const QString &xPosRole, const QString &yPosRole, const QString &zPosRole, const QStringList &rowCategories, const QStringList &columnCategories)

Modifica la asignación de rowRole, columnRole, xPosRole, yPosRole, zPosRole, rowCategories y columnCategories.

[invokable] int QItemModelSurfaceDataProxy::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 metaobjetos y desde QML. Véase Q_INVOKABLE.

void QItemModelSurfaceDataProxy::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.