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 roleSi 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 ».
| Constante | Valor | Descripción |
|---|---|---|
QItemModelSurfaceDataProxy::MMBFirst | 0 | Los valores de posición se toman del primer elemento del modelo de elementos que coincide con cada combinación de fila y columna. |
QItemModelSurfaceDataProxy::MMBLast | 1 | Los valores de posición se toman del último elemento del modelo de elementos que coincide con cada combinación de fila y columna. |
QItemModelSurfaceDataProxy::MMBAverage | 2 | Se 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::MMBCumulativeY | 3 | Para 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.