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 DataVisualization)
target_link_libraries(mytarget PRIVATE Qt6::DataVisualization)
qmake: QT += datavisualization
Desde: QtDataVisualization 1.0
En QML: SurfaceDataProxy
Heredado de: QAbstractDataProxy
Heredado por:

QHeightMapSurfaceDataProxy y QItemModelSurfaceDataProxy

Estado: Obsoleto

Esta clase está obsoleta. Recomendamos encarecidamente no utilizarla en código nuevo.

Propiedades

Funciones públicas

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

Señales

void arrayReset()
void columnCountChanged(int count)
void itemChanged(int rowIndex, int columnIndex)
void rowCountChanged(int count)
void rowsAdded(int startIndex, int count)
void rowsChanged(int startIndex, int count)
void rowsInserted(int startIndex, int count)
void rowsRemoved(int startIndex, int 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 definiciones de tipo auxiliares: `QtDataVisualization::QSurfaceDataArray` y `QtDataVisualization::QSurfaceDataRow`. ` QSurfaceDataArray ` es un ` QList ` que controla las filas. ` QSurfaceDataRow ` es un ` QList ` que contiene objetos ` 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 Q3DSurface.

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 no se consideran válidas y no se renderizarán.

Nota: En algunos entornos, es posible que las superficies con muchos vértices visibles no se rendericen, ya que superan el número de vértices por dibujo que admite el controlador gráfico. Este problema se da principalmente en plataformas de 32 bits y OpenGL ES2.

Véase también «Qt Data Visualization: Manejo de datos».

Documentación de propiedades

[read-only] columnCount : int

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

Funciones de acceso:

int columnCount() const

Señal de notificación:

void columnCountChanged(int count)

[read-only] rowCount : int

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

Funciones de acceso:

int rowCount() const

Señal de notificación:

void rowCountChanged(int 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 de 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.

[virtual noexcept] QSurfaceDataProxy::~QSurfaceDataProxy()

Elimina el proxy de datos de superficie.

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

int QSurfaceDataProxy::addRows(const 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.

const QSurfaceDataArray *QSurfaceDataProxy::array() const

Devuelve el puntero a la matriz de datos.

[signal] void QSurfaceDataProxy::arrayReset()

Esta señal se emite cuando se reinicia 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(int 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(int rowIndex, const 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(const 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(int rowIndex, int 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(int rowIndex, int 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 en la matriz sin llamar a setItem(), es necesario emitir esta señal para actualizar el gráfico.

void QSurfaceDataProxy::removeRows(int rowIndex, int 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(QSurfaceDataArray *newArray)

Asume la propiedad de la matriz newArray. Borra la matriz existente si la nueva matriz difiere de ella. Si las matrices son iguales, esta función simplemente activa la señal arrayReset().

Si se pasa un array nulo, se elimina el array anterior y se crea un nuevo array vacío. Todas las filas de newArray deben tener la misma longitud.

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

Esta señal se emite cuando se añaden el número de filas especificado por « count », comenzando en 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(int startIndex, int 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(int startIndex, int 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(int startIndex, int count)

Esta señal se emite cuando se eliminan el número de filas especificado por ` count `, comenzando 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(const QPoint &position, const 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(int rowIndex, int columnIndex, const QSurfaceDataItem &item)

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

void QSurfaceDataProxy::setRow(int 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(int rowIndex, const 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

QSurfaceDataArray

Una lista de punteros a objetos de tipo « QSurfaceDataRow ».

QSurfaceDataRow

Una lista de objetos « 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.