QBar3DSeries Class
La clase QBar3DSeries representa una serie de datos en un gráfico de barras 3D. Más...
| Cabecera: | #include <QBar3DSeries> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS DataVisualization)target_link_libraries(mytarget PRIVATE Qt6::DataVisualization) |
| qmake: | QT += datavisualization |
| Desde: | QtDataVisualization 1.0 |
| En QML: | Bar3DSeries |
| Hereda: | QAbstract3DSeries |
Propiedades
- dataProxy : QBarDataProxy*
- meshAngle : float
(since 6.3)rowColors : QList<QColor>- selectedBar : QPoint
Funciones públicas
| QBar3DSeries(QObject *parent = nullptr) | |
| QBar3DSeries(QBarDataProxy *dataProxy, QObject *parent = nullptr) | |
| virtual | ~QBar3DSeries() |
| QBarDataProxy * | dataProxy() const |
| float | meshAngle() const |
| QList<QColor> | rowColors() const |
| QPoint | selectedBar() const |
| void | setDataProxy(QBarDataProxy *proxy) |
| void | setMeshAngle(float angle) |
| void | setRowColors(const QList<QColor> &colors) |
| void | setSelectedBar(const QPoint &position) |
Señales
| void | dataProxyChanged(QBarDataProxy *proxy) |
| void | meshAngleChanged(float angle) |
| void | rowColorsChanged(const QList<QColor> &rowcolors) |
| void | selectedBarChanged(const QPoint &position) |
Miembros públicos estáticos
| QPoint | invalidSelectionPosition() |
Descripción detallada
Esta clase gestiona los elementos visuales específicos de la serie, así como los datos de la serie (a través de un proxy de datos).
Si no se establece un proxy de datos explícitamente para la serie, la serie crea un proxy por defecto. Establecer otro proxy destruirá el proxy existente y todos los datos añadidos a él.
QBar3DSeries soporta las siguientes etiquetas de formato para QAbstract3DSeries::setItemLabelFormat():
| @rowTitle | Título del eje de filas |
| @colTitle | Título del eje de columnas |
| @valueTitle | Título del eje de valores |
| @rowIdx | Índice de fila visible. Localizado usando la configuración regional del gráfico. |
| @colIdx | Índice de columna visible. Localizado utilizando la configuración regional del gráfico. |
| @etiquetaFila | Etiqueta del eje de filas |
| @colEtiqueta | Etiqueta del eje de columnas |
| @valorEtiqueta | Valor del elemento formateado utilizando el formato del eje de valor adjunto al gráfico. Para obtener más información, consulte QValue3DAxis::labelFormat. |
| @nombreDeLaSerie | Nombre de la serie |
| %<especificación de formato> | Valor del elemento en el formato especificado. Formateado utilizando las mismas reglas que QValue3DAxis::labelFormat. |
Por ejemplo:
proxy->setItemLabelFormat(QStringLiteral("@valueTitle for (@rowLabel, @colLabel): %.1f"));
Véase también Qt Data Visualization Manejo de datos y QAbstract3DGraph::locale.
Documentación de propiedades
dataProxy : QBarDataProxy*
Esta propiedad contiene el proxy de datos activo.
La serie asume la propiedad de cualquier proxy que se le asigne y elimina cualquier proxy previamente asignado cuando se añade uno nuevo. El proxy no puede ser nulo ni estar asignado a otra serie.
Funciones de acceso:
| QBarDataProxy * | dataProxy() const |
| void | setDataProxy(QBarDataProxy *proxy) |
Señal del notificador:
| void | dataProxyChanged(QBarDataProxy *proxy) |
meshAngle : float
Esta propiedad contiene el ángulo de rotación de la serie en grados.
Establecer esta propiedad equivale a la siguiente llamada:
setMeshRotation(QQuaternion::fromAxisAndAngle(0.0f, 1.0f, 0.0f, angle))
Nota: Al leer esta propiedad, se calcula a partir del valor QAbstract3DSeries::meshRotation utilizando precisión de coma flotante y siempre devuelve un valor de cero a 360 grados.
Funciones de acceso:
| float | meshAngle() const |
| void | setMeshAngle(float angle) |
Señal del notificador:
| void | meshAngleChanged(float angle) |
Véase también QAbstract3DSeries::meshRotation.
[since 6.3] rowColors : QList<QColor>
Esta propiedad contiene la lista de colores de las filas de la serie.
Esta propiedad se puede utilizar para colorear las filas de la serie en diferentes colores. Para utilizar esta propiedad, Q3DTheme::ColorStyle debe tener el valor Q3DTheme::ColorStyleUniform.
Esta propiedad se introdujo en Qt 6.3.
Funciones de acceso:
| QList<QColor> | rowColors() const |
| void | setRowColors(const QList<QColor> &colors) |
Señal de notificador:
| void | rowColorsChanged(const QList<QColor> &rowcolors) |
Véase también Q3DTheme::ColorStyleUniform.
selectedBar : QPoint
Esta propiedad contiene la barra de la serie que está seleccionada.
Funciones de acceso:
| QPoint | selectedBar() const |
| void | setSelectedBar(const QPoint &position) |
Señal del notificador:
| void | selectedBarChanged(const QPoint &position) |
Documentación de funciones miembro
[explicit] QBar3DSeries::QBar3DSeries(QObject *parent = nullptr)
Construye una serie 3D de barras con el padre parent.
[explicit] QBar3DSeries::QBar3DSeries(QBarDataProxy *dataProxy, QObject *parent = nullptr)
Construye una serie 3D de barras con el proxy de datos dataProxy y el padre parent.
[virtual noexcept] QBar3DSeries::~QBar3DSeries()
Borra una serie de barras 3D.
[static] QPoint QBar3DSeries::invalidSelectionPosition()
Devuelve una posición inválida para la selección. Esta posición se establece en la propiedad selectedBar para borrar la selección de esta serie.
Véase también QAbstract3DGraph::clearSelection().
void QBar3DSeries::setSelectedBar(const QPoint &position)
Selecciona la barra en la posición position, especificada como fila y columna en la matriz de datos de la serie.
Sólo se puede seleccionar una barra a la vez.
Para borrar la selección de esta serie, invalidSelectionPosition() se establece como position.
Si se añade esta serie a un gráfico, éste puede ajustar la selección según la interacción del usuario o si deja de ser válida. La selección de una barra en otra serie añadida también borrará la selección.
Eliminar filas de la serie o insertar filas en ella antes de la fila de la barra seleccionada ajustará la selección de forma que la misma barra permanecerá seleccionada.
Nota: Función Setter para la propiedad selectedBar.
Véase también selectedBar() y QAbstract3DGraph::clearSelection().
© 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.
