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 |
- Lista de todos los miembros, incluidos los heredados
- QItemModelScatterDataProxy forma parte de las clases C++ de «Qt Graphs » para 3D.
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.