En esta página

QItemModelScatterDataProxy Class

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

Encabezado: #include <QItemModelScatterDataProxy>
CMake: find_package(Qt6 REQUIRED COMPONENTS DataVisualization)
target_link_libraries(mytarget PRIVATE Qt6::DataVisualization)
qmake: QT += datavisualization
Desde: QtDataVisualization 1.0
En QML: ItemModelScatterDataProxy
Heredado de: QScatterDataProxy
Estado: Obsoleta

Esta clase está obsoleta. Recomendamos encarecidamente no utilizarla en código nuevo.

Propiedades

Funciones públicas

QItemModelScatterDataProxy(QObject *parent = nullptr)
QItemModelScatterDataProxy(QAbstractItemModel *itemModel, QObject *parent = nullptr)
QItemModelScatterDataProxy(QAbstractItemModel *itemModel, const QString &xPosRole, const QString &yPosRole, const QString &zPosRole, QObject *parent = nullptr)
QItemModelScatterDataProxy(QAbstractItemModel *itemModel, const QString &xPosRole, const QString &yPosRole, const QString &zPosRole, const QString &rotationRole, QObject *parent = nullptr)
virtual ~QItemModelScatterDataProxy()
QAbstractItemModel *itemModel() const
void remap(const QString &xPosRole, const QString &yPosRole, const QString &zPosRole, const QString &rotationRole)
QString rotationRole() const
QRegularExpression rotationRolePattern() const
QString rotationRoleReplace() const
void setItemModel(QAbstractItemModel *itemModel)
void setRotationRole(const QString &role)
void setRotationRolePattern(const QRegularExpression &pattern)
void setRotationRoleReplace(const QString &replace)
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)
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 itemModelChanged(const QAbstractItemModel *itemModel)
void rotationRoleChanged(const QString &role)
void rotationRolePatternChanged(const QRegularExpression &pattern)
void rotationRoleReplaceChanged(const QString &replace)
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

QItemModelScatterDataProxy permite utilizar modelos derivados de ` QAbstractItemModel ` como fuente de datos para ` Q3DScatter`. Asigna los roles de ` QAbstractItemModel ` a los valores XYZ de los puntos de ` Q3DScatter `.

Los datos se resuelven de forma asíncrona cada vez que cambia la asignación o el modelo. Se emite QScatterDataProxy::arrayReset() cuando se han resuelto los datos. Sin embargo, las inserciones, eliminaciones y cambios en elementos de datos individuales tras la inicialización del modelo 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.

La asignación ignora las filas y columnas de la matriz de datos ( QAbstractItemModel ) y trata todos los elementos por igual. Requiere que el modelo proporcione roles para los elementos de datos que puedan asignarse a los valores X, Y y Z de los puntos de dispersión.

Por ejemplo, supongamos que tienes un « QAbstractItemModel » personalizado para almacenar diversas mediciones realizadas en muestras de material, que proporciona datos para roles como «densidad», «dureza» y «conductividad». Podrías visualizar estas propiedades en un gráfico de dispersión utilizando este proxy:

// Map "density" value to X-axis, "hardness" to Y-axis and "conductivity" to Z-axis.
QItemModelScatterDataProxy *proxy = new QItemModelScatterDataProxy(customModel,
                                                                   QStringLiteral("density"),
                                                                   QStringLiteral("hardness"),
                                                                   QStringLiteral("conductivity"));

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, sobre el uso de los patrones de búsqueda junto con los roles, véase el uso de ItemModelBarDataProxy en el ejemplo «Gráfico de barras simple ».

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

Documentación sobre propiedades

itemModel : QAbstractItemModel*

Esta propiedad contiene el modelo de elemento que se utilizará como fuente de datos para una serie de dispersión en 3D.

Funciones de acceso:

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

Señal de notificación:

void itemModelChanged(const QAbstractItemModel *itemModel)

rotationRole : QString

Esta propiedad desempeña la función de modelo de artículo para asignarlo a la rotación de artículos.

El modelo puede proporcionar el valor de rotación como una variante directamente convertible a ` QQuaternion`, o como una de las siguientes representaciones de cadena: ` "scalar,x,y,z" ` o ` "@angle,x,y,z"`. La primera opción construirá el cuaternión directamente con los valores proporcionados, mientras que la segunda lo construirá utilizando el método ` QQuaternion::fromAxisAndAngle()`.

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 determina si se lleva a cabo una búsqueda y sustitución en el valor asignado por la función de rotación antes de que se utilice como rotación de elemento.

Esta propiedad especifica la expresión regular para encontrar 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 del notificador:

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 el patrón de función de rotación.

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

void rotationRoleReplaceChanged(const QString &replace)

Véase también rotationRole y rotationRolePattern.

xPosRole : QString

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

Funciones de acceso:

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

Señal de notificación:

void xPosRoleChanged(const QString &role)

xPosRolePattern : QRegularExpression

Esta propiedad determina 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 encontrar 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 de notificación:

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

void xPosRoleReplaceChanged(const QString &replace)

Véase también xPosRole y xPosRolePattern.

yPosRole : QString

Esta propiedad desempeña la función de modelo del elemento para asignarlo a 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 determina 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 encontrar 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 notificación:

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 el patrón de posición «y».

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

Señal de notificador:

void yPosRoleReplaceChanged(const QString &replace)

Véase también yPosRole y yPosRolePattern.

zPosRole : QString

Esta propiedad desempeña la función de modelo del elemento para asignarlo a la posición Z.

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 determina si se lleva a cabo 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 de notificación:

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 el 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 notificación:

void zPosRoleReplaceChanged(const QString &replace)

Véase también zPosRole y zPosRolePattern.

Documentación de funciones de miembro

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

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

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

Crea un objeto `QItemModelScatterDataProxy` 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] QItemModelScatterDataProxy::QItemModelScatterDataProxy(QAbstractItemModel *itemModel, const QString &xPosRole, const QString &yPosRole, const QString &zPosRole, QObject *parent = nullptr)

Crea un objeto `QItemModelScatterDataProxy` 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 propiedad ` xPosRole ` se establece en ` xPosRole`, la propiedad ` yPosRole ` en ` yPosRole` y la propiedad ` zPosRole ` en ` zPosRole`.

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

Crea un objeto `QItemModelScatterDataProxy` 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 propiedad ` xPosRole ` se establece en ` xPosRole`, la propiedad ` yPosRole ` en ` yPosRole`, la propiedad ` zPosRole ` en ` zPosRole` y la propiedad ` rotationRole ` en ` rotationRole`.

[virtual noexcept] QItemModelScatterDataProxy::~QItemModelScatterDataProxy()

Destruye « QItemModelScatterDataProxy ».

void QItemModelScatterDataProxy::remap(const QString &xPosRole, const QString &yPosRole, const QString &zPosRole, const QString &rotationRole)

Cambios en la asignación de xPosRole, yPosRole, zPosRole y rotationRole.

void QItemModelScatterDataProxy::setItemModel(QAbstractItemModel *itemModel)

Establece ` itemModel ` como modelo de elemento para `Q3DScatter`. 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.