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.