En esta página

QBarDataProxy Class

La clase QBarDataProxy es el proxy de datos para un gráfico de barras en 3D. Más información...

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

QItemModelBarDataProxy

Propiedades

Funciones públicas

QBarDataProxy(QObject *parent = nullptr)
virtual ~QBarDataProxy() override
qsizetype addRow(QBarDataRow row)
qsizetype addRow(QBarDataRow row, QString label)
qsizetype addRows(QBarDataArray rows)
qsizetype addRows(QBarDataArray rows, QStringList labels)
qsizetype colCount() const
void insertRow(qsizetype rowIndex, QBarDataRow row)
void insertRow(qsizetype rowIndex, QBarDataRow row, QString label)
void insertRows(qsizetype rowIndex, QBarDataArray rows)
void insertRows(qsizetype rowIndex, QBarDataArray rows, QStringList labels)
const QBarDataItem &itemAt(QPoint position) const
const QBarDataItem &itemAt(qsizetype rowIndex, qsizetype columnIndex) const
void removeRows(qsizetype rowIndex, qsizetype removeCount, QBarDataProxy::RemoveLabels removeLabels = RemoveLabels::No)
void resetArray()
void resetArray(QBarDataArray newArray)
void resetArray(QBarDataArray newArray, QStringList rowLabels, QStringList columnLabels)
const QBarDataRow &rowAt(qsizetype rowIndex) const
qsizetype rowCount() const
QBar3DSeries *series() const
void setItem(QPoint position, QBarDataItem item)
void setItem(qsizetype rowIndex, qsizetype columnIndex, QBarDataItem item)
void setRow(qsizetype rowIndex, QBarDataRow row)
void setRow(qsizetype rowIndex, QBarDataRow row, QString label)
void setRows(qsizetype rowIndex, QBarDataArray rows)
void setRows(qsizetype rowIndex, QBarDataArray rows, QStringList labels)

Señales

void arrayReset()
void colCountChanged(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(QBar3DSeries *series)

Descripción detallada

Un proxy de datos de barras se encarga de añadir, insertar, modificar y eliminar filas de datos.

La matriz de datos es una lista de vectores (filas) de instancias de ` QBarDataItem `. Cada fila puede contener un número diferente de elementos o incluso estar vacía.

QBarDataProxy asume la propiedad de todos los objetos QtGraphs::QBarDataRow que se le pasan, ya sea directamente o en un contenedor QtGraphs::QBarDataArray. Si se utilizan punteros a filas de datos de barras para modificar directamente los datos tras añadir la matriz al proxy, se debe emitir la señal adecuada para actualizar el gráfico.

QBarDataProxy realiza un seguimiento opcional de las etiquetas de filas y columnas, que QCategory3DAxis puede utilizar para mostrar las etiquetas de los ejes.

Las etiquetas de filas y columnas se almacenan en un array independiente de los datos de la serie. El proxy dispone de métodos de procesamiento de filas que ofrecen versiones alternativas que no afectan a las etiquetas de las filas. Esto permite tener etiquetas de filas que se refieran a la posición de los datos en el array, en lugar de a los datos en sí. Dado que la serie contiene los datos y las etiquetas de filas y columnas, es necesario crear una serie asociada al proxy antes de utilizar estas funciones con ellas.

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

Documentación de propiedades

[read-only] colCount : qsizetype

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

Funciones de acceso:

qsizetype colCount() const

Señal de notificación:

void colCountChanged(qsizetype count)

[read-only] rowCount : qsizetype

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

Funciones de acceso:

qsizetype rowCount() const

Señal del notificador:

void rowCountChanged(qsizetype count)

[read-only] series : QBar3DSeries*

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

Funciones de acceso:

QBar3DSeries *series() const

Señal de notificador:

void seriesChanged(QBar3DSeries *series)

Documentación de funciones de miembro

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

Crea un proxy de datos de barras con el ` parent` indicado.

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

Elimina el proxy de datos de la barra.

qsizetype QBarDataProxy::addRow(QBarDataRow row)

Añade la nueva fila « row » al final de una matriz. Las etiquetas de las filas existentes no se ven afectadas.

Devuelve el índice de la fila añadida.

qsizetype QBarDataProxy::addRow(QBarDataRow row, QString label)

Añade una nueva fila « row » con la etiqueta « label » al final de una matriz.

Devuelve el índice de la fila añadida.

qsizetype QBarDataProxy::addRows(QBarDataArray rows)

Añade el nuevo objeto ` rows ` al final de un array. Las etiquetas de fila existentes no se ven afectadas.

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

qsizetype QBarDataProxy::addRows(QBarDataArray rows, QStringList labels)

Añade el nuevo elemento rows con labels al final de la matriz.

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

[signal] void QBarDataProxy::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 QBarDataProxy::insertRow(qsizetype rowIndex, QBarDataRow 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. Las etiquetas de las filas existentes no se ven afectadas.

Nota: La matriz de etiquetas de filas quedará desincronizada con la matriz de filas tras esta llamada si había filas etiquetadas más allá de la fila insertada.

void QBarDataProxy::insertRow(qsizetype rowIndex, QBarDataRow row, QString label)

Inserta la nueva fila row con la etiqueta label en rowIndex. Si rowIndex es igual al tamaño del array, las filas se añaden al final del array.

void QBarDataProxy::insertRows(qsizetype rowIndex, QBarDataArray rows)

Inserta un nuevo ` rows ` en ` rowIndex`. Si ` rowIndex ` es igual al tamaño del array, las filas se añaden al final del mismo. Las etiquetas de las filas existentes no se ven afectadas.

Nota: El array de etiquetas de filas quedará desincronizado con el array de filas tras esta llamada si había filas etiquetadas más allá de las filas insertadas.

void QBarDataProxy::insertRows(qsizetype rowIndex, QBarDataArray rows, QStringList labels)

Inserta un nuevo « rows » con « labels » en « rowIndex ». Si « rowIndex » es igual al tamaño de la matriz, las filas se añaden al final de la matriz.

const QBarDataItem &QBarDataProxy::itemAt(QPoint position) const

Devuelve la referencia 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 será válido únicamente hasta la siguiente llamada que modifique los datos.

const QBarDataItem &QBarDataProxy::itemAt(qsizetype rowIndex, qsizetype columnIndex) const

Devuelve la referencia 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 QBarDataProxy::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 en la matriz sin llamar a setItem(), es necesario emitir esta señal para actualizar el gráfico.

void QBarDataProxy::removeRows(qsizetype rowIndex, qsizetype removeCount, QBarDataProxy::RemoveLabels removeLabels = RemoveLabels::No)

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. Si ` removeLabels ` es ` true`, también se eliminan las etiquetas de las filas correspondientes. En caso contrario, las etiquetas de las filas no se ven afectadas.

Nota: Si removeLabels es false, el array de etiquetas de fila quedará desincronizado con el array de filas si hay filas etiquetadas más allá de las filas eliminadas.

void QBarDataProxy::resetArray()

Borra la matriz existente y las etiquetas de filas y columnas.

void QBarDataProxy::resetArray(QBarDataArray newArray)

Adquiere 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().

Al pasar un array nulo, se elimina el array antiguo y se crea uno nuevo vacío. Las etiquetas de filas y columnas no se ven afectadas.

void QBarDataProxy::resetArray(QBarDataArray newArray, QStringList rowLabels, QStringList columnLabels)

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

Si se pasa un matriz nulo, se elimina el matriz antiguo y se crea uno nuevo vacío.

Las listas rowLabels y columnLabels especifican las nuevas etiquetas para las filas y las columnas.

const QBarDataRow &QBarDataProxy::rowAt(qsizetype rowIndex) const

Devuelve la referencia a la fila situada en la posición rowIndex. Se garantiza su validez únicamente hasta la siguiente llamada que modifique los datos.

[signal] void QBarDataProxy::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 QBarDataProxy::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 QBarDataProxy::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 QBarDataProxy::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 QBarDataProxy::setItem(QPoint position, QBarDataItem 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 QBarDataProxy::setItem(qsizetype rowIndex, qsizetype columnIndex, QBarDataItem item)

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

void QBarDataProxy::setRow(qsizetype rowIndex, QBarDataRow 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. Las etiquetas de las filas existentes no se ven afectadas.

void QBarDataProxy::setRow(qsizetype rowIndex, QBarDataRow row, QString label)

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. Cambia la etiqueta de la fila por label.

void QBarDataProxy::setRows(qsizetype rowIndex, QBarDataArray rows)

Modifica las filas existentes sustituyendo las filas que comienzan en la posición rowIndex por las nuevas filas especificadas en rows. Las etiquetas de las filas existentes no se ven afectadas. Las filas del array rows pueden ser las mismas que las filas existentes ya almacenadas en rowIndex.

void QBarDataProxy::setRows(qsizetype rowIndex, QBarDataArray rows, QStringList labels)

Modifica las filas existentes sustituyendo las filas que comienzan en la posición rowIndex por las nuevas filas especificadas en rows. Las etiquetas de las filas se cambian a labels. Las filas del array rows pueden ser las mismas que las filas existentes ya almacenadas en rowIndex.

No miembros relacionados

[alias] QBarDataArray

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

[alias] QBarDataRow

Una lista de objetos de tipo ` QBarDataItem `.

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