En esta página

QScatterDataProxy Class

La clase QScatterDataProxy es el proxy de datos para gráficos de dispersión 3D. Más...

Cabecera: #include <QScatterDataProxy>
CMake: find_package(Qt6 REQUIRED COMPONENTS Graphs)
target_link_libraries(mytarget PRIVATE Qt6::Graphs)
qmake: QT += graphs
En QML: ScatterDataProxy
Hereda de: QAbstractDataProxy
Heredado por:

QItemModelScatterDataProxy

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)

Descripción detallada

Un proxy de datos de dispersión gestiona la adición, inserción, modificación y eliminación de 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 se apropia de todos los objetos QtGraphs::QScatterDataArray y QScatterDataItem que se le pasan.

Ver también Qt Graphs Manejo de Datos con 3D.

Documentación de Propiedades

[read-only] itemCount : qsizetype

Esta propiedad contiene el número de elementos de la matriz.

Funciones de acceso:

qsizetype itemCount() const

Señal del notificador:

void itemCountChanged(qsizetype count)

[read-only] series : QScatter3DSeries*

Esta propiedad contiene la serie a la que se adjunta este proxy.

Funciones de acceso:

QScatter3DSeries *series() const

Señal del notificador:

void seriesChanged(QScatter3DSeries *series)

Documentación de la función miembro

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

Construye QScatterDataProxy con la dirección parent.

[override virtual noexcept] QScatterDataProxy::~QScatterDataProxy()

Elimina el proxy de datos de dispersión.

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 del array.

Devuelve el índice del primer elemento añadido.

[signal] void QScatterDataProxy::arrayReset()

Esta señal se emite cuando se reinicia la matriz de datos. Si se cambia el contenido de toda la matriz sin llamar a 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 en el índice index. Se garantiza que sólo será válido hasta la siguiente llamada que modifique los datos.

[signal] void QScatterDataProxy::itemsAdded(qsizetype startIndex, qsizetype count)

Esta señal se emite cuando se añade el número de elementos especificado por count, comenzando en 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 el número de elementos especificados por count se modifican, comenzando en la posición startIndex. Si se cambian elementos en 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 inserta el número de elementos especificado por count, comenzando en la posición startIndex. Si se insertan elementos en la matriz sin llamar a insertItem() o insertItems(), esta señal debe emitirse para actualizar el gráfico.

[signal] void QScatterDataProxy::itemsRemoved(qsizetype startIndex, qsizetype count)

Esta señal se emite cuando se elimina 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 se eliminan elementos del final. Si se eliminan elementos de la matriz 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. El intento de eliminar elementos más allá del final de la matriz no hace nada.

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 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 en el índice index. Se garantiza que sólo será válido hasta la siguiente llamada que modifique los datos.

void QScatterDataProxy::setItem(qsizetype index, QScatterDataItem item)

Sustituye el elemento en 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 por items.

Relacionados No miembros

[alias] QScatterDataArray

Una lista de objetos QScatterDataItem.

© 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.