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 DataVisualization) target_link_libraries(mytarget PRIVATE Qt6::DataVisualization) |
| qmake: | QT += datavisualization |
| Desde: | QtDataVisualization 1.0 |
| En QML: | BarDataProxy |
| Heredado de: | QAbstractDataProxy |
| Heredado por: | |
| Estado: | Obsoleto |
Esta clase está obsoleta. Se desaconseja encarecidamente su uso en código nuevo.
Propiedades
- columnLabels : QStringList
- rowCount : int
- rowLabels : QStringList
- series : QBar3DSeries*
Funciones públicas
| QBarDataProxy(QObject *parent = nullptr) | |
| virtual | ~QBarDataProxy() |
| int | addRow(QBarDataRow *row) |
| int | addRow(QBarDataRow *row, const QString &label) |
| int | addRows(const QBarDataArray &rows) |
| int | addRows(const QBarDataArray &rows, const QStringList &labels) |
| const QBarDataArray * | array() const |
| QStringList | columnLabels() const |
| void | insertRow(int rowIndex, QBarDataRow *row) |
| void | insertRow(int rowIndex, QBarDataRow *row, const QString &label) |
| void | insertRows(int rowIndex, const QBarDataArray &rows) |
| void | insertRows(int rowIndex, const QBarDataArray &rows, const QStringList &labels) |
| const QBarDataItem * | itemAt(const QPoint &position) const |
| const QBarDataItem * | itemAt(int rowIndex, int columnIndex) const |
| void | removeRows(int rowIndex, int removeCount, bool removeLabels = true) |
| void | resetArray() |
| void | resetArray(QBarDataArray *newArray) |
| void | resetArray(QBarDataArray *newArray, const QStringList &rowLabels, const QStringList &columnLabels) |
| const QBarDataRow * | rowAt(int rowIndex) const |
| int | rowCount() const |
| QStringList | rowLabels() const |
| QBar3DSeries * | series() const |
| void | setColumnLabels(const QStringList &labels) |
| void | setItem(const QPoint &position, const QBarDataItem &item) |
| void | setItem(int rowIndex, int columnIndex, const QBarDataItem &item) |
| void | setRow(int rowIndex, QBarDataRow *row) |
| void | setRow(int rowIndex, QBarDataRow *row, const QString &label) |
| void | setRowLabels(const QStringList &labels) |
| void | setRows(int rowIndex, const QBarDataArray &rows) |
| void | setRows(int rowIndex, const QBarDataArray &rows, const QStringList &labels) |
Señales
| void | arrayReset() |
| void | columnLabelsChanged() |
| void | itemChanged(int rowIndex, int columnIndex) |
| void | rowCountChanged(int count) |
| void | rowLabelsChanged() |
| 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(QBar3DSeries *series) |
Elementos no miembros relacionados
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 ser nula.
QBarDataProxy asume la propiedad de todos los objetos QtDataVisualization::QBarDataRow que se le pasan, ya sea directamente o en un contenedor QtDataVisualization::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, y los métodos de manipulación de filas 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í.
Véase también «Qt Data Visualization: Manejo de datos».
Documentación de propiedades
columnLabels : QStringList
Esta propiedad contiene las etiquetas de columna opcionales para la matriz.
Los índices de esta matriz coinciden con los índices de las columnas en las filas. Si la lista es más corta que la fila más larga, no se asignarán etiquetas a todas las columnas.
Funciones de acceso:
| QStringList | columnLabels() const |
| void | setColumnLabels(const QStringList &labels) |
Señal de notificación:
| void | columnLabelsChanged() |
[read-only] rowCount : int
Esta propiedad contiene el número de filas del array.
Funciones de acceso:
| int | rowCount() const |
Señal de notificación:
| void | rowCountChanged(int count) |
rowLabels : QStringList
Esta propiedad contiene las etiquetas de fila opcionales para la matriz.
Los índices de esta matriz coinciden con los índices de fila de la matriz de datos. Si la lista es más corta que el número de filas, no todas las filas tendrán etiquetas.
Funciones de acceso:
| QStringList | rowLabels() const |
| void | setRowLabels(const QStringList &labels) |
Señal de notificación:
| void | rowLabelsChanged() |
[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 las funciones de miembro
[explicit] QBarDataProxy::QBarDataProxy(QObject *parent = nullptr)
Crea un proxy de datos de barras con el ` parent` indicado.
[virtual noexcept] QBarDataProxy::~QBarDataProxy()
Elimina el proxy de datos de la barra.
int 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.
int QBarDataProxy::addRow(QBarDataRow *row, const QString &label)
Añade una nueva fila « row » con la etiqueta « label » al final de un array.
Devuelve el índice de la fila añadida.
int QBarDataProxy::addRows(const QBarDataArray &rows)
Añade el nuevo objeto ` rows ` al final de una matriz. Las etiquetas de las filas existentes no se ven afectadas.
Devuelve el índice de la primera fila añadida.
int QBarDataProxy::addRows(const QBarDataArray &rows, const QStringList &labels)
Añade el nuevo elemento rows con labels al final de la matriz.
Devuelve el índice de la primera fila añadida.
const QBarDataArray *QBarDataProxy::array() const
Devuelve el puntero a la matriz de datos.
[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 ` resetArray()`, es necesario emitir esta señal para actualizar el gráfico.
void QBarDataProxy::insertRow(int 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(int rowIndex, QBarDataRow *row, const 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(int rowIndex, const QBarDataArray &rows)
Inserta un nuevo ` rows ` 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: 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(int rowIndex, const QBarDataArray &rows, const QStringList &labels)
Inserta un nuevo elemento rows con labels en rowIndex. Si rowIndex es igual al tamaño del array, las filas se añaden al final del mismo.
const QBarDataItem *QBarDataProxy::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 será válido únicamente hasta la siguiente llamada que modifique los datos.
const QBarDataItem *QBarDataProxy::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 QBarDataProxy::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 QBarDataProxy::removeRows(int rowIndex, int removeCount, bool removeLabels = true)
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 fila correspondientes. En caso contrario, las etiquetas de fila 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)
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().
Al pasar un array nulo, se elimina el array anterior y se crea un nuevo array vacío. Las etiquetas de filas y columnas no se ven afectadas.
void QBarDataProxy::resetArray(QBarDataArray *newArray, const QStringList &rowLabels, const QStringList &columnLabels)
Asume la propiedad del array ` newArray`. Borra el array existente si el nuevo array difiere de él. Si los arrays son iguales, esta función simplemente activa la señal ` arrayReset()`.
Si se pasa un array nulo, se elimina el array antiguo y se crea un nuevo array vacío.
Las listas rowLabels y columnLabels especifican las nuevas etiquetas para las filas y las columnas.
const QBarDataRow *QBarDataProxy::rowAt(int rowIndex) const
Devuelve el puntero 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(int startIndex, int count)
Esta señal se emite cuando se añaden 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(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 de la matriz sin llamar a ` setRow()` o ` setRows()`, es necesario emitir esta señal para actualizar el gráfico.
[signal] void QBarDataProxy::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 QBarDataProxy::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 QBarDataProxy::setItem(const QPoint &position, const 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(int rowIndex, int columnIndex, const QBarDataItem &item)
Cambia un único elemento situado en la posición especificada por rowIndex y columnIndex por el elemento item.
void QBarDataProxy::setRow(int 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(int rowIndex, QBarDataRow *row, const 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 a label.
void QBarDataProxy::setRows(int rowIndex, const 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(int rowIndex, const QBarDataArray &rows, const 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
QBarDataArray
Una lista de punteros a objetos ` QBarDataRow `.
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.