QScatterDataProxy Class
La clase QScatterDataProxy es el proxy de datos para los gráficos de dispersión en 3D. Más información...
| Encabezado: | #include <QScatterDataProxy> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Graphs) target_link_libraries(mytarget PRIVATE Qt6::Graphs) |
| qmake: | QT += graphs |
| En QML: | ScatterDataProxy |
| Heredado de: | QAbstractDataProxy |
| Heredado por: |
- Lista de todos los miembros, incluidos los heredados
- QScatterDataProxy forma parte de las clases C++ «Qt Graphs » para 3D.
Propiedades
Funciones públicas
| QScatterDataProxy(QObject *parent = nullptr) | |
| virtual | ~QScatterDataProxy() override |
| qsizetype | addItem(QScatterDataItem item) |
| qsizetype | addItems(QScatterDataArray items) |
| void | insertItem(qsizetype index, QScatterDataItem item) |
| void | insertItems(qsizetype index, QScatterDataArray items) |
| const QScatterDataItem & | itemAt(qsizetype index) const |
| qsizetype | itemCount() const |
| void | removeItems(qsizetype index, qsizetype removeCount) |
| void | resetArray() |
| void | resetArray(QScatterDataArray newArray) |
| void | resetScaleArray(QList<QVector3D> newArray) |
| QVector3D | scaleAt(qsizetype index) const |
| QScatter3DSeries * | series() const |
| void | setItem(qsizetype index, QScatterDataItem item) |
| void | setItems(qsizetype index, QScatterDataArray items) |
Señales
| void | arrayReset() |
| void | itemCountChanged(qsizetype count) |
| void | itemsAdded(qsizetype startIndex, qsizetype count) |
| void | itemsChanged(qsizetype startIndex, qsizetype count) |
| void | itemsInserted(qsizetype startIndex, qsizetype count) |
| void | itemsRemoved(qsizetype startIndex, qsizetype count) |
| void | seriesChanged(QScatter3DSeries *series) |
Elementos no miembros relacionados
Descripción detallada
Un proxy de datos dispersos se encarga de añadir, insertar, modificar y eliminar elementos de datos. Dado que los datos se almacenan en series, es necesario crear una serie asociada al proxy antes de utilizar estas funciones para el conjunto de datos.
QScatterDataProxy asume la propiedad de todos los objetos QtGraphs::QScatterDataArray y QScatterDataItem que se le pasan.
Véase también «Qt Graphs: gestión de datos en 3D».
Documentación de propiedades
[read-only] itemCount : qsizetype
Esta propiedad contiene el número de elementos del array.
Funciones de acceso:
| qsizetype | itemCount() const |
Señal de notificación:
| void | itemCountChanged(qsizetype count) |
[read-only] series : QScatter3DSeries*
Esta propiedad contiene la serie a la que está asociado este proxy.
Funciones de acceso:
| QScatter3DSeries * | series() const |
Señal del notificador:
| void | seriesChanged(QScatter3DSeries *series) |
Documentación de las funciones de miembro
[explicit] QScatterDataProxy::QScatterDataProxy(QObject *parent = nullptr)
Crea un objeto `QScatterDataProxy` con el ` parent` proporcionado.
[override virtual noexcept] QScatterDataProxy::~QScatterDataProxy()
Elimina el proxy de datos dispersos.
qsizetype QScatterDataProxy::addItem(QScatterDataItem item)
Añade el elemento item al final de la matriz.
Devuelve el índice del elemento añadido.
qsizetype QScatterDataProxy::addItems(QScatterDataArray items)
Añade los elementos especificados por ` items ` al final de la matriz.
Devuelve el índice del primer elemento añadido.
[signal] void QScatterDataProxy::arrayReset()
Esta señal se emite cuando se restablece la matriz de datos. Si se modifica el contenido de toda la matriz sin llamar a la función ` resetArray()`, es necesario emitir esta señal para actualizar el gráfico.
void QScatterDataProxy::insertItem(qsizetype index, QScatterDataItem item)
Inserta el elemento item en la posición index. Si el índice es igual al tamaño de la matriz de datos, el elemento se añade a la matriz.
void QScatterDataProxy::insertItems(qsizetype index, QScatterDataArray items)
Inserta los elementos especificados por ` items ` en la posición ` index`. Si el índice es igual al tamaño de la matriz de datos, los elementos se añaden a la matriz.
const QScatterDataItem &QScatterDataProxy::itemAt(qsizetype index) const
Devuelve el puntero al elemento situado en el índice index. Se garantiza su validez únicamente hasta la siguiente llamada que modifique los datos.
[signal] void QScatterDataProxy::itemsAdded(qsizetype startIndex, qsizetype count)
Esta señal se emite cuando se añaden el número de elementos especificado por ` count `, a partir de la posición ` startIndex`. Si se añaden elementos a la matriz sin llamar a ` addItem()` o ` addItems()`, es necesario emitir esta señal para actualizar el gráfico.
[signal] void QScatterDataProxy::itemsChanged(qsizetype startIndex, qsizetype count)
Esta señal se emite cuando se modifica el número de elementos especificado por « count », a partir de la posición « startIndex ». Si se modifican elementos de la matriz sin llamar a « setItem()» o « setItems()», es necesario emitir esta señal para actualizar el gráfico.
[signal] void QScatterDataProxy::itemsInserted(qsizetype startIndex, qsizetype count)
Esta señal se emite cuando se insertan el número de elementos especificado por ` count `, a partir de la posición ` startIndex`. Si se insertan elementos en la matriz sin llamar a ` insertItem()` o ` insertItems()`, es necesario emitir esta señal para actualizar el gráfico.
[signal] void QScatterDataProxy::itemsRemoved(qsizetype startIndex, qsizetype count)
Esta señal se emite cuando se eliminan el número de filas especificado por ` count `, comenzando en la posición ` startIndex`. El índice puede ser mayor que el tamaño actual del array si los elementos se eliminan desde el final. Si se eliminan elementos del array sin llamar a ` removeItems()`, es necesario emitir esta señal para actualizar el gráfico.
void QScatterDataProxy::removeItems(qsizetype index, qsizetype removeCount)
Elimina el número de elementos especificado por « removeCount » a partir de la posición « index ». Si se intenta eliminar elementos más allá del final de la matriz, no se produce ningún efecto.
void QScatterDataProxy::resetArray()
Borra la matriz existente y activa la señal « arrayReset()».
void QScatterDataProxy::resetArray(QScatterDataArray newArray)
Establece la matriz a partir de newArray. Si la nueva matriz es igual a la existente, esta función simplemente activa la señal arrayReset().
void QScatterDataProxy::resetScaleArray(QList<QVector3D> newArray)
Establece la matriz de escala a partir de newArray. Si la nueva matriz es igual a la existente, esta función simplemente activa la señal scaleArrayReset().
QVector3D QScatterDataProxy::scaleAt(qsizetype index) const
Devuelve los datos de escala correspondientes al índice index. Se garantiza su validez únicamente hasta la siguiente llamada que modifique los datos.
void QScatterDataProxy::setItem(qsizetype index, QScatterDataItem item)
Sustituye el elemento de la posición index por el elemento item.
void QScatterDataProxy::setItems(qsizetype index, QScatterDataArray items)
Sustituye los elementos a partir de la posición index por los elementos especificados en items.
© 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.