QBarDataProxy Class
La clase QBarDataProxy es el proxy de datos para un gráfico de barras 3D. Más...
| Cabecera: | #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 |
| Hereda de: | QAbstractDataProxy |
| Heredado de: |
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) |
Relacionados No miembros
Descripción detallada
Un proxy de datos de barra se encarga de añadir, insertar, cambiar 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 se apropia de todos los objetos QtDataVisualization::QBarDataRow que se le pasan, ya sea directamente o en un contenedor QtDataVisualization::QBarDataArray. Si se utilizan punteros de fila de datos de barra para modificar directamente los datos después de añadir el array al proxy, se debe emitir la señal apropiada para actualizar el gráfico.
QBarDataProxy mantiene opcionalmente un registro de las etiquetas de fila y columna, que QCategory3DAxis puede utilizar para mostrar las etiquetas de los ejes. Las etiquetas de filas y columnas se almacenan en una matriz separada de los datos y los métodos de manipulación de filas proporcionan versiones alternativas que no afectan a las etiquetas de filas. Esto permite la opción de tener etiquetas de fila que se relacionan con la posición de los datos en la matriz en lugar de los datos en sí.
Véase también Qt Data Visualization Manipulación de datos.
Documentación de propiedades
columnLabels : QStringList
Esta propiedad contiene las etiquetas opcionales de las columnas de la matriz.
Los índices de esta matriz coinciden con los índices de columna de las filas. Si la lista es más corta que la fila más larga, no todas las columnas tendrán etiquetas.
Funciones de acceso:
| QStringList | columnLabels() const |
| void | setColumnLabels(const QStringList &labels) |
Señal del notificador:
| void | columnLabelsChanged() |
[read-only] rowCount : int
Esta propiedad contiene el número de filas de la matriz.
Funciones de acceso:
| int | rowCount() const |
Señal del notificador:
| void | rowCountChanged(int count) |
rowLabels : QStringList
Esta propiedad contiene las etiquetas opcionales de las filas de 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 del notificador:
| void | rowLabelsChanged() |
[read-only] series : QBar3DSeries*
Esta propiedad contiene la serie a la que se adjunta este proxy.
Funciones de acceso:
| QBar3DSeries * | series() const |
Señal del notificador:
| void | seriesChanged(QBar3DSeries *series) |
Documentación de la función miembro
[explicit] QBarDataProxy::QBarDataProxy(QObject *parent = nullptr)
Construye un proxy de datos de barras con la dirección parent.
[virtual noexcept] QBarDataProxy::~QBarDataProxy()
Borra 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 la nueva 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 la nueva rows con labels al final del array.
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 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 QBarDataProxy::insertRow(int rowIndex, QBarDataRow *row)
Inserta la nueva fila row en rowIndex. Si rowIndex es igual al tamaño del array, las filas se añaden al final del array. Las etiquetas de filas existentes no se ven afectadas.
Nota: El array de etiquetas de fila estará desincronizado con el array de filas después de 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 el nuevo rows en rowIndex. Si rowIndex es igual al tamaño del array, las filas se añaden al final del array. Las etiquetas de fila existentes no se ven afectadas.
Nota: El array de etiquetas de fila estará desincronizado con el array de filas después de 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 el nuevo rows con labels en rowIndex. Si rowIndex es igual al tamaño del array, las filas se añaden al final del array.
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 sólo será válido hasta la siguiente llamada que modifique los datos.
const QBarDataItem *QBarDataProxy::itemAt(int rowIndex, int columnIndex) const
Devuelve el puntero al elemento en la posición especificada por rowIndex y columnIndex. Se garantiza que sólo será válido 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 en la posición especificada por rowIndex y columnIndex. Si el elemento se cambia en la matriz sin llamar a setItem(), esta señal debe emitirse para actualizar el gráfico.
void QBarDataProxy::removeRows(int rowIndex, int removeCount, bool removeLabels = true)
Elimina el número de filas especificado por removeCount comenzando en la posición rowIndex. Intentar eliminar filas más allá del final del array no hace nada. Si removeLabels es true, también se eliminan las etiquetas de fila correspondientes. En caso contrario, las etiquetas de las filas no se ven afectadas.
Nota: Si removeLabels es false, la matriz de etiquetas de fila no estará sincronizada con la matriz de filas si hay filas etiquetadas más allá de las filas eliminadas.
void QBarDataProxy::resetArray()
Borra la matriz existente y las etiquetas de fila y columna.
void QBarDataProxy::resetArray(QBarDataArray *newArray)
Toma posesión del array newArray. Borra la matriz existente si la nueva matriz difiere de ella. Si las matrices son iguales, esta función sólo activa la señal arrayReset().
Si se pasa una matriz nula, se borra la matriz antigua y se crea una nueva matriz vacía. Las etiquetas de filas y columnas no se ven afectadas.
void QBarDataProxy::resetArray(QBarDataArray *newArray, const QStringList &rowLabels, const QStringList &columnLabels)
Toma posesión del array newArray. Borra la matriz existente si la nueva matriz difiere de ella. Si las matrices son iguales, esta función sólo activa la señal arrayReset().
Si se pasa un array nulo se borra el array antiguo y se crea un nuevo array vacío.
Las listas rowLabels y columnLabels especifican las nuevas etiquetas para filas y columnas.
const QBarDataRow *QBarDataProxy::rowAt(int rowIndex) const
Devuelve el puntero a la fila en la posición rowIndex. Se garantiza que sólo será válido hasta la siguiente llamada que modifique los datos.
[signal] void QBarDataProxy::rowsAdded(int startIndex, int count)
Esta señal se emite cuando se añade 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 QBarDataProxy::rowsChanged(int startIndex, int count)
Esta señal se emite cuando el número de filas especificado por count se modifica a partir de la posición startIndex. Si se cambian filas en el array sin llamar a setRow() o setRows(), esta señal debe ser emitida para actualizar el gráfico.
[signal] void QBarDataProxy::rowsInserted(int startIndex, int count)
Esta señal se emite cuando el número de filas especificado por count se inserta en la posición startIndex.
Si se insertan filas en el array sin llamar a insertRow() o insertRows(), esta señal debe ser emitida para actualizar el gráfico.
[signal] void QBarDataProxy::rowsRemoved(int startIndex, int 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 es el tamaño actual del array si las filas se han eliminado desde el final del array. 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 en la posición position al 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 en la posición especificada por rowIndex y columnIndex al elemento item.
void QBarDataProxy::setRow(int rowIndex, QBarDataRow *row)
Modifica una fila existente sustituyendo la fila en la posición rowIndex por la nueva fila especificada por row. La nueva fila puede ser la misma que 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 en la posición rowIndex por la nueva fila especificada por row. La nueva fila puede ser la misma que 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 por rows. Las etiquetas de las filas existentes no se ven afectadas. Las filas de la matriz rows pueden ser las mismas que las filas existentes ya almacenadas en rowIndex.
void QBarDataProxy::setRows(int rowIndex, const QBarDataArray &rows, const QStringList &labels)
Cambia las filas existentes sustituyendo las filas que comienzan en la posición rowIndex por las nuevas filas especificadas por rows. Las etiquetas de las filas se cambian a labels. Las filas de la matriz 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 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.