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 Graphs)target_link_libraries(mytarget PRIVATE Qt6::Graphs) |
| qmake: | QT += graphs |
| En QML: | BarDataProxy |
| Hereda de: | QAbstractDataProxy |
| Heredado por: |
- Lista de todos los miembros, incluyendo los heredados
- QBarDataProxy es parte de Qt Graphs C++ Classes for 3D.
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) |
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 QtGraphs::QBarDataRow que se le pasan, ya sea directamente o en un contenedor QtGraphs::QBarDataArray. Si se usan punteros a filas de datos de barras 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 fila y columna se almacenan en una matriz separada de los datos de la serie. Los métodos de procesamiento de filas están disponibles en el proxy y proporcionan versiones alternativas que no afectan a las etiquetas de filas. Esto permite la opción de tener etiquetas de fila que se refieren a la posición de los datos en la matriz en lugar de los propios datos. Dado que la serie contiene los datos y las etiquetas de fila y columna, es necesario crear una serie asociada al proxy antes de utilizar estas funciones para ellos.
Véase también Qt Graphs Manejo de datos con 3D.
Documentación de Propiedades
[read-only] colCount : qsizetype
Esta propiedad contiene el número de columnas de la matriz.
Funciones de acceso:
| qsizetype | colCount() const |
Señal del notificador:
| void | colCountChanged(qsizetype count) |
[read-only] rowCount : qsizetype
Esta propiedad contiene el número de filas de la matriz.
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 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.
[override virtual noexcept] QBarDataProxy::~QBarDataProxy()
Borra 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 un array.
Devuelve el índice de la fila añadida.
qsizetype QBarDataProxy::addRows(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.
qsizetype QBarDataProxy::addRows(QBarDataArray rows, QStringList labels)
Añade la nueva rows con labels al final del array.
Devuelve el índice de la primera fila añadida.
[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(qsizetype 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(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 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(qsizetype rowIndex, QBarDataArray rows, 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(QPoint position) const
Devuelve la referencia al elemento 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(qsizetype rowIndex, qsizetype columnIndex) const
Devuelve la referencia al elemento en la posición especificada por rowIndex y columnIndex. Se garantiza que sólo será válida 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 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(qsizetype rowIndex, qsizetype removeCount, QBarDataProxy::RemoveLabels removeLabels = RemoveLabels::No)
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, QStringList rowLabels, 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(qsizetype rowIndex) const
Devuelve la referencia a la fila en la posición rowIndex. Se garantiza que sólo será válida 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, 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(qsizetype startIndex, qsizetype count)
Esta señal se emite cuando el número de filas especificado por count se modifica, comenzando en la posición startIndex. Si se cambian filas en el 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 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(qsizetype startIndex, qsizetype 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(QPoint position, 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(qsizetype rowIndex, qsizetype columnIndex, QBarDataItem item)
Cambia un único elemento en la posición especificada por rowIndex y columnIndex al elemento item.
void QBarDataProxy::setRow(qsizetype 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(qsizetype rowIndex, QBarDataRow row, 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(qsizetype rowIndex, 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(qsizetype rowIndex, QBarDataArray rows, 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
[alias] QBarDataArray
Una lista de punteros a objetos QBarDataRow.
[alias] 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.