QBar3DSeries Class
La clase QBar3DSeries representa una serie de datos en un gráfico de barras en 3D. Más información...
| Encabezado: | #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 |
| Heredado de: | QAbstract3DSeries |
| Estado: | Obsoleta |
Esta clase está obsoleta. Recomendamos encarecidamente no utilizarla en código nuevo.
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 misma (a través de un proxy de datos).
Si no se establece explícitamente ningún proxy de datos para la serie, esta crea un proxy por defecto. Al establecer otro proxy, se eliminará el proxy existente y todos los datos añadidos al mismo.
QBar3DSeries admite 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 la fila visible. Localizado según la configuración regional del gráfico. |
| @colIdx | Índice de la columna visible. Localizado según la configuración regional del gráfico. |
| @rowLabel | Etiqueta del eje de filas |
| @colLabel | Etiqueta del eje de columnas |
| @valueLabel | Valor del elemento formateado según el formato del eje de valores asociado al gráfico. Para obtener más información, consulta QValue3DAxis::labelFormat. |
| @seriesName | Nombre de la serie |
| %<especificación de formato> | Valor del elemento en el formato especificado. Se formatea siguiendo las mismas reglas que en QValue3DAxis::labelFormat. |
Por ejemplo:
proxy->setItemLabelFormat(QStringLiteral("@valueTitle for (@rowLabel, @colLabel): %.1f"));Véase también «Qt Data Visualization: Gestión 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 establecido anteriormente 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 de notificación:
| 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 comprendido entre cero y 360 grados.
Funciones de acceso:
| float | meshAngle() const |
| void | setMeshAngle(float angle) |
Señal de notificación:
| 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 con diferentes colores. Para utilizar esta propiedad, la propiedad « Q3DTheme::ColorStyle » debe estar establecida en « Q3DTheme::ColorStyleUniform ».
Esta enumeración se introdujo en Qt 6.3.
Funciones de acceso:
| QList<QColor> | rowColors() const |
| void | setRowColors(const QList<QColor> &colors) |
Señal de notificación:
| void | rowColorsChanged(const QList<QColor> &rowcolors) |
Véase también Q3DTheme::ColorStyleUniform.
selectedBar : QPoint
Esta propiedad contiene la barra de la serie seleccionada.
Funciones de acceso:
| QPoint | selectedBar() const |
| void | setSelectedBar(const QPoint &position) |
Señal de notificador:
| void | selectedBarChanged(const QPoint &position) |
Documentación de las funciones de miembro
[explicit] QBar3DSeries::QBar3DSeries(QObject *parent = nullptr)
Crea una barra de la serie 3D con el elemento principal « parent ».
[explicit] QBar3DSeries::QBar3DSeries(QBarDataProxy *dataProxy, QObject *parent = nullptr)
Crea una serie de gráficos de barras en 3D con el proxy de datos dataProxy y el elemento principal parent.
[virtual noexcept] QBar3DSeries::~QBar3DSeries()
Elimina una serie de barras en 3D.
[static] QPoint QBar3DSeries::invalidSelectionPosition()
Devuelve una posición no válida para la selección. Esta posición se asigna a 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 situada en la posición position, especificada como una fila y una columna en la matriz de datos de la serie.
Solo se puede seleccionar una barra a la vez.
Para desmarcar la selección de esta serie, se establece ` invalidSelectionPosition()` como ` position`.
Si esta serie se añade a un gráfico, este puede ajustar la selección en función de la interacción del usuario o si deja de ser válida. Seleccionar una barra de otra serie añadida también desactivará la selección.
Si se eliminan o se insertan filas en la serie antes de la fila de la barra seleccionada, la selección se ajustará de modo que dicha barra siga seleccionada.
Nota: Funciónde configuración 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.