En esta página

QItemModelScatterDataProxy Class

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

Encabezado: #include <QItemModelScatterDataProxy>
CMake: find_package(Qt6 REQUIRED COMPONENTS Graphs)
target_link_libraries(mytarget PRIVATE Qt6::Graphs)
qmake: QT += graphs
En QML: ItemModelScatterDataProxy
Heredan de: QScatterDataProxy

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() override
QAbstractItemModel *itemModel() const
void remap(const QString &xPosRole, const QString &yPosRole, const QString &zPosRole, const QString &rotationRole)
void remap(const QString &xPosRole, const QString &yPosRole, const QString &zPosRole, const QString &rotationRole, const QString &scaleRole)
QString rotationRole() const
QRegularExpression rotationRolePattern() const
QString rotationRoleReplace() const
QString scaleRole() const
QRegularExpression scaleRolePattern() const
QString scaleRoleReplace() const
void setItemModel(QAbstractItemModel *itemModel)
void setRotationRole(const QString &role)
void setRotationRolePattern(const QRegularExpression &pattern)
void setRotationRoleReplace(const QString &replace)
void setScaleRole(const QString &role)
void setScaleRolePattern(const QRegularExpression &pattern)
void setScaleRoleReplace(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 scaleRoleChanged(const QString &role)
void scaleRolePatternChanged(const QRegularExpression &pattern)
void scaleRoleReplaceChanged(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 Q3DScatterWidgetItem. Asigna los roles de QAbstractItemModel a los valores XYZ de los puntos de Q3DScatterWidgetItem.

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 un único elemento de datos 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 del « 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, para saber cómo utilizar los patrones de búsqueda junto con los roles, consulta el uso de ItemModelBarDataProxy en el gráfico de barras simple.

Véase también «Qt Graphs: manejo de datos en 3D».

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 elemento para asignarlo a la rotación de elementos.

El modelo puede proporcionar el valor de rotación bien como una variante directamente convertible a un QQuaternion, bien 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 indica 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 del elemento.

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

Funciones de acceso:

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

Señal de 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 de notificador:

void rotationRoleReplaceChanged(const QString &replace)

Véase también rotationRole y rotationRolePattern.

scaleRole : QString

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

El modelo puede proporcionar el valor de la escala como una variante de tipo « "x,y,z" ». La primera opción creará el vector3d directamente con los valores proporcionados.

Funciones de acceso:

QString scaleRole() const
void setScaleRole(const QString &role)

Señal de notificación:

void scaleRoleChanged(const QString &role)

scaleRolePattern : QRegularExpression

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

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

Funciones de acceso:

QRegularExpression scaleRolePattern() const
void setScaleRolePattern(const QRegularExpression &pattern)

Señal de notificación:

void scaleRolePatternChanged(const QRegularExpression &pattern)

Véase también scaleRole y scaleRoleReplace.

scaleRoleReplace : QString

Esta propiedad contiene el contenido de sustitución que se utilizará junto con el patrón de función «scale».

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 scaleRoleReplace() const
void setScaleRoleReplace(const QString &replace)

Señal del notificador:

void scaleRoleReplaceChanged(const QString &replace)

Véase también scaleRole y scaleRolePattern.

xPosRole : QString

Esta propiedad desempeña la función de modelo de elemento para asignar 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 realiza 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 propieda 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 función 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 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 del 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 el patrón 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 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 del notificador:

void zPosRoleChanged(const QString &role)

zPosRolePattern : QRegularExpression

Esta propiedad determina 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 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 del notificador:

void zPosRoleReplaceChanged(const QString &replace)

Véase también zPosRole y zPosRolePattern.

Documentación de la función 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 un ` parent` opcional. 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 un ` itemModel ` y un ` parent` opcional. El proxy no asume la propiedad de ` itemModel`, ya que los modelos de elemento suelen ser 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 un ` parent` opcional. El proxy no asume la propiedad de ` itemModel`, ya que los modelos de elemento suelen ser 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`.

[override 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::remap(const QString &xPosRole, const QString &yPosRole, const QString &zPosRole, const QString &rotationRole, const QString &scaleRole)

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

void QItemModelScatterDataProxy::setItemModel(QAbstractItemModel *itemModel)

Establece ` itemModel ` como modelo del elemento ` Q3DScatterWidgetItem`. 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.