En esta página

QSurfaceDataProxy Class

La clase QSurfaceDataProxy es el proxy de datos de un gráfico de superficie 3D. Más información...

Encabezado: #include <QSurfaceDataProxy>
CMake: find_package(Qt6 REQUIRED COMPONENTS Graphs)
target_link_libraries(mytarget PRIVATE Qt6::Graphs)
qmake: QT += graphs
En QML: SurfaceDataProxy
Heredado de: QAbstractDataProxy
Heredado por:

QHeightMapSurfaceDataProxy y QItemModelSurfaceDataProxy

Propiedades

Funciones públicas

QSurfaceDataProxy(QObject *parent = nullptr)
virtual ~QSurfaceDataProxy() override
qsizetype addRow(QSurfaceDataRow row)
qsizetype addRows(QSurfaceDataArray rows)
qsizetype columnCount() const
void insertRow(qsizetype rowIndex, QSurfaceDataRow row)
void insertRows(qsizetype rowIndex, QSurfaceDataArray rows)
const QSurfaceDataItem &itemAt(QPoint position) const
const QSurfaceDataItem &itemAt(qsizetype rowIndex, qsizetype columnIndex) const
void removeRows(qsizetype rowIndex, qsizetype removeCount)
void resetArray()
void resetArray(QSurfaceDataArray newArray)
qsizetype rowCount() const
QSurface3DSeries *series() const
void setItem(QPoint position, QSurfaceDataItem item)
void setItem(qsizetype rowIndex, qsizetype columnIndex, QSurfaceDataItem item)
void setRow(qsizetype rowIndex, QSurfaceDataRow row)
void setRows(qsizetype rowIndex, QSurfaceDataArray rows)

Señales

void arrayReset()
void columnCountChanged(qsizetype count)
void itemChanged(qsizetype rowIndex, qsizetype columnIndex)
void rowCountChanged(qsizetype count)
void rowsAdded(qsizetype startIndex, qsizetype count)
void rowsChanged(qsizetype startIndex, qsizetype count)
void rowsInserted(qsizetype startIndex, qsizetype count)
void rowsRemoved(qsizetype startIndex, qsizetype count)
void seriesChanged(QSurface3DSeries *series)

Descripción detallada

Un proxy de datos de superficie gestiona los datos relacionados con la superficie en filas. Para ello, proporciona dos alias de tipo auxiliares: QtGraphs::QSurfaceDataArray y QtGraphs::QSurfaceDataRow. QSurfaceDataArray es un objeto de tipo « QList » que controla las filas. QSurfaceDataRow es un objeto de tipo « QList » que contiene objetos de tipo « QSurfaceDataItem ». Para obtener más información sobre cómo proporcionar los datos al proxy, consulta el código de ejemplo de la documentación de Q3DSurfaceWidgetItem. 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.

Todas las filas deben tener el mismo número de elementos.

QSurfaceDataProxy asume la propiedad de todos los objetos QSurfaceDataRow que se le pasan, ya sea directamente o en un contenedor QSurfaceDataArray. Para utilizar los punteros de fila de datos de superficie con el fin de modificar directamente los datos tras añadir la matriz al proxy, debe emitirse la señal adecuada para actualizar el gráfico.

Para crear una superficie coherente, el valor x de cada elemento sucesivo en todas las filas debe ser ascendente o descendente a lo largo de la fila. Del mismo modo, el valor z de cada elemento sucesivo en todas las columnas debe ser ascendente o descendente a lo largo de la columna.

Nota: Actualmente solo se admiten plenamente las superficies con filas y columnas rectas. Cualquier fila con elementos que no tengan exactamente el mismo valor z, o cualquier columna con elementos que no tengan exactamente el mismo valor x, puede recortarse incorrectamente si la superficie completa no cabe por completo dentro de los rangos visibles del eje x o del eje z.

Nota: Las superficies con menos de dos filas o columnas se representan como líneas.

Nota: En algunos entornos, es posible que las superficies con muchos vértices visibles no se representen, ya que superan el número de vértices por dibujo admitido por el controlador gráfico. Esto suele ser un problema en plataformas de 32 bits y OpenGL ES2.

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

Documentación de propiedades

[read-only] columnCount : qsizetype

Esta propiedad contiene el número de columnas del array de datos.

Funciones de acceso:

qsizetype columnCount() const

Señal de notificación:

void columnCountChanged(qsizetype count)

[read-only] rowCount : qsizetype

Esta propiedad contiene el número de filas del array de datos.

Funciones de acceso:

qsizetype rowCount() const

Señal de notificación:

void rowCountChanged(qsizetype count)

[read-only] series : QSurface3DSeries*

Esta propiedad contiene la serie a la que está asociado este proxy.

Funciones de acceso:

QSurface3DSeries *series() const

Señal del notificador:

void seriesChanged(QSurface3DSeries *series)

Documentación de las funciones de miembro

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

Crea un objeto `QSurfaceDataProxy` con el ` parent` proporcionado.

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

Elimina el proxy de datos de superficie.

qsizetype QSurfaceDataProxy::addRow(QSurfaceDataRow row)

Añade la nueva fila row al final de una matriz. La nueva fila debe tener el mismo número de columnas que las filas de la matriz inicial.

Devuelve el índice de la fila añadida.

qsizetype QSurfaceDataProxy::addRows(QSurfaceDataArray rows)

Añade nuevas filas ( rows ) al final de una matriz. Las nuevas filas deben tener el mismo número de columnas que las filas de la matriz inicial.

Devuelve el índice de la primera fila añadida.

[signal] void QSurfaceDataProxy::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 QSurfaceDataProxy::insertRow(qsizetype rowIndex, QSurfaceDataRow row)

Inserta la nueva fila « row » en « rowIndex ». Si « rowIndex » es igual al tamaño de la matriz, las filas se añaden al final de la matriz. La nueva fila debe tener el mismo número de columnas que las filas de la matriz inicial.

void QSurfaceDataProxy::insertRows(qsizetype rowIndex, QSurfaceDataArray rows)

Inserta el nuevo rows en rowIndex. Si rowIndex es igual al tamaño del array, las filas se añaden al final del array. El nuevo rows debe tener el mismo número de columnas que las filas del array inicial.

const QSurfaceDataItem &QSurfaceDataProxy::itemAt(QPoint position) const

Devuelve el puntero al elemento situado en la posición position. El valor x de position indica la fila y el valor y indica la columna. Se garantiza que el elemento sea válido únicamente hasta la siguiente llamada que modifique los datos.

const QSurfaceDataItem &QSurfaceDataProxy::itemAt(qsizetype rowIndex, qsizetype columnIndex) const

Devuelve el puntero al elemento situado en la posición especificada por rowIndex y columnIndex. Se garantiza su validez únicamente hasta la siguiente llamada que modifique los datos.

[signal] void QSurfaceDataProxy::itemChanged(qsizetype rowIndex, qsizetype columnIndex)

Esta señal se emite cuando cambia el elemento situado en la posición especificada por rowIndex y columnIndex. Si se modifica el elemento de la matriz sin llamar a setItem(), es necesario emitir esta señal para actualizar el gráfico.

void QSurfaceDataProxy::removeRows(qsizetype rowIndex, qsizetype removeCount)

Elimina el número de filas especificado por ` removeCount `, empezando por la posición ` rowIndex`. Si se intenta eliminar filas más allá del final de la matriz, no se produce ningún efecto.

void QSurfaceDataProxy::resetArray()

Borra la matriz existente y activa la señal « arrayReset()».

void QSurfaceDataProxy::resetArray(QSurfaceDataArray 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().

[signal] void QSurfaceDataProxy::rowsAdded(qsizetype startIndex, qsizetype count)

Esta señal se emite cuando se añade el número de filas especificado por ` count `, a partir de la posición ` startIndex`. Si se añaden filas a la matriz sin llamar a ` addRow()` o ` addRows()`, es necesario emitir esta señal para actualizar el gráfico.

[signal] void QSurfaceDataProxy::rowsChanged(qsizetype startIndex, qsizetype count)

Esta señal se emite cuando se modifica el número de filas especificado por ` count `, a partir de la posición ` startIndex`. Si se modifican las filas del array sin llamar a ` setRow()` o ` setRows()`, es necesario emitir esta señal para actualizar el gráfico.

[signal] void QSurfaceDataProxy::rowsInserted(qsizetype startIndex, qsizetype count)

Esta señal se emite cuando se inserta el número de filas especificado por ` count ` en la posición ` startIndex`.

Si se insertan filas en la matriz sin llamar a insertRow() o insertRows(), es necesario emitir esta señal para actualizar el gráfico.

[signal] void QSurfaceDataProxy::rowsRemoved(qsizetype startIndex, qsizetype count)

Esta señal se emite cuando se eliminan el número de filas especificado por ` count `, empezando por la posición ` startIndex`.

El índice corresponde al tamaño actual de la matriz si las filas se han eliminado del final de la misma. Si se eliminan filas de la matriz sin llamar a ` removeRows()`, es necesario emitir esta señal para actualizar el gráfico.

void QSurfaceDataProxy::setItem(QPoint position, QSurfaceDataItem item)

Cambia un único elemento situado en la posición position por el elemento item. El valor x de position indica la fila y el valor y indica la columna.

void QSurfaceDataProxy::setItem(qsizetype rowIndex, qsizetype columnIndex, QSurfaceDataItem item)

Cambia un único elemento situado en la posición especificada por rowIndex y columnIndex por el elemento item.

void QSurfaceDataProxy::setRow(qsizetype rowIndex, QSurfaceDataRow row)

Modifica una fila existente sustituyendo la fila situada en la posición rowIndex por la nueva fila especificada en row. La nueva fila puede ser idéntica a la fila existente ya almacenada en rowIndex. La nueva fila debe tener el mismo número de columnas que la fila a la que sustituye.

void QSurfaceDataProxy::setRows(qsizetype rowIndex, QSurfaceDataArray rows)

Modifica las filas existentes sustituyendo las filas que comienzan en la posición rowIndex por las nuevas filas especificadas en rows. Las filas del array rows pueden ser las mismas que las filas existentes ya almacenadas en rowIndex. Las nuevas filas deben tener el mismo número de columnas que las filas a las que sustituyen.

Elementos no miembros relacionados

[alias] QSurfaceDataArray

Una lista de punteros a objetos de tipo ` QSurfaceDataRow `.

[alias] QSurfaceDataRow

Una lista de objetos de tipo « QSurfaceDataItem ».

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