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 Graphs) target_link_libraries(mytarget PRIVATE Qt6::Graphs) |
| qmake: | QT += graphs |
| En QML: | Bar3DSeries |
| Heredan de: | QAbstract3DSeries |
- Lista de todos los miembros, incluidos los heredados
- QBar3DSeries forma parte de las clases C++ deQt Graphs para 3D.
Propiedades
|
|
Funciones públicas
| QBar3DSeries(QObject *parent = nullptr) | |
| QBar3DSeries(QBarDataProxy *dataProxy, QObject *parent = nullptr) | |
| virtual | ~QBar3DSeries() override |
| void | clearArray() |
| void | clearRow(qsizetype rowIndex) |
| QCategory3DAxis * | columnAxis() const |
| QStringList | columnLabels() const |
| QStringList | customColumnLabels() const |
| QStringList | customRowLabels() const |
| const QBarDataArray & | dataArray() const & |
| QBarDataArray | dataArray() && |
| QBarDataProxy * | dataProxy() const |
| bool | isValueColoringEnabled() const |
| float | meshAngle() const |
| void | resetColumnAxis() |
| void | resetRowAxis() |
| void | resetValueAxis() |
| QCategory3DAxis * | rowAxis() const |
| QList<QColor> | rowColors() const |
| QStringList | rowLabels() const |
| QPoint | selectedBar() const |
| void | setColumnAxis(QCategory3DAxis *axis) |
| void | setColumnLabels(const QStringList &labels) |
| void | setCustomColumnLabels(const QStringList &labels) |
| void | setCustomRowLabels(const QStringList &labels) |
| void | setDataArray(const QBarDataArray &newDataArray) |
| void | setDataProxy(QBarDataProxy *proxy) |
| void | setMeshAngle(float angle) |
| void | setRowAxis(QCategory3DAxis *axis) |
| void | setRowColors(const QList<QColor> &colors) |
| void | setRowLabels(const QStringList &labels) |
| void | setSelectedBar(QPoint position) |
| void | setValueAxis(QValue3DAxis *axis) |
| void | setValueColoringEnabled(bool enabled) |
| QValue3DAxis * | valueAxis() const |
Señales
| void | columnAxisChanged(QCategory3DAxis *axis) |
| void | columnLabelsChanged() |
| void | customColumnLabelsChanged(const QStringList &newCustomColumnLabels) |
| void | customRowLabelsChanged(const QStringList &newCustomRowLabels) |
| void | dataArrayChanged(const QBarDataArray &array) |
| void | dataProxyChanged(QBarDataProxy *proxy) |
| void | meshAngleChanged(float angle) |
| void | rowAxisChanged(QCategory3DAxis *axis) |
| void | rowColorsChanged(const QList<QColor> &rowcolors) |
| void | rowLabelsChanged() |
| void | selectedBarChanged(QPoint position) |
| void | valueAxisChanged(QValue3DAxis *axis) |
| void | valueColoringEnabledChanged(bool enabled) |
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).
En cuanto a la relación entre el proxy y la serie, es fundamental destacar un par de puntos clave. En este contexto, los datos se almacenan en series y los usuarios pueden acceder al conjunto de datos a través de las series. Estas series están controladas o representadas por un objeto proxy. Por lo tanto, el proxy puede utilizarse para gestionar diversas operaciones sobre los datos y actualizar el conjunto de datos real. Sin embargo, es necesario crear una serie asociada a este proxy para editar el conjunto 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 a la serie.
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 Graphs: Manejo de datos con 3D » y « Q3DGraphsWidgetItem::locale ».
Documentación de propiedades
[since 6.11] columnAxis : QCategory3DAxis*
Incluye un eje de columna adicional para la serie
Nota: El eje adicional no modifica el ajuste del gráfico, pero permite añadir un conjunto adicional de etiquetas y una cuadrícula de ejes.
Esta enumeración se introdujo en Qt 6.11.
Funciones de acceso:
| QCategory3DAxis * | columnAxis() const |
| void | setColumnAxis(QCategory3DAxis *axis) |
| void | resetColumnAxis() |
Señal de notificación:
| void | columnAxisChanged(QCategory3DAxis *axis) |
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 de 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() |
[since 6.11] customColumnLabels : QStringList
Esta propiedad contiene las etiquetas de columna personalizadas opcionales para la matriz.
Estas etiquetas anularán cualquier etiqueta generada por un proxy. 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.
Esta enumeración se introdujo en Qt 6.11.
Funciones de acceso:
| QStringList | customColumnLabels() const |
| void | setCustomColumnLabels(const QStringList &labels) |
Señal de notificador:
| void | customColumnLabelsChanged(const QStringList &newCustomColumnLabels) |
[since 6.11] customRowLabels : QStringList
Esta propiedad contiene las etiquetas de fila personalizadas opcionales para la matriz.
Estas etiquetas anularán cualquier etiqueta generada por un proxy. Los índices de este array coinciden con los índices de fila del array de datos. Si la lista es más corta que el número de filas, no todas las filas tendrán etiquetas.
Esta enumeración se introdujo en Qt 6.11.
Funciones de acceso:
| QStringList | customRowLabels() const |
| void | setCustomRowLabels(const QStringList &labels) |
Señal del notificador:
| void | customRowLabelsChanged(const QStringList &newCustomRowLabels) |
dataArray : QBarDataArray
Matriz de datos de la serie.
Contiene la referencia del matriz de datos.
La señal «dataArrayChanged» se emite cuando se establece la matriz de datos, a menos que « newDataArray » sea idéntico al anterior.
Nota: Antes de realizar cualquier operación relacionada con `dataArray`, es necesario crear una serie para el proxy correspondiente.
Funciones de acceso:
| const QBarDataArray & | dataArray() const & |
| QBarDataArray | dataArray() && |
| void | setDataArray(const QBarDataArray &newDataArray) |
Señal de notificador:
| void | dataArrayChanged(const QBarDataArray &array) |
Véase también ` clearRow(qsizetype rowIndex)` y ` clearArray()`.
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 punto 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.11] rowAxis : QCategory3DAxis*
Incluye un eje de filas adicional para la serie
Nota: El eje adicional no modifica el ajuste del gráfico, pero permite añadir un conjunto adicional de etiquetas y una cuadrícula de ejes.
Esta enumeración se introdujo en Qt 6.11.
Funciones de acceso:
| QCategory3DAxis * | rowAxis() const |
| void | setRowAxis(QCategory3DAxis *axis) |
| void | resetRowAxis() |
Señal de notificación:
| void | rowAxisChanged(QCategory3DAxis *axis) |
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, es necesario establecer la propiedad « QGraphsTheme::ColorStyle » en « QGraphsTheme::ColorStyle::Uniform ».
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 QGraphsTheme::ColorStyle::Uniform.
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() |
selectedBar : QPoint
Esta propiedad contiene la barra de la serie seleccionada.
Funciones de acceso:
| QPoint | selectedBar() const |
| void | setSelectedBar(QPoint position) |
Señal de notificación:
| void | selectedBarChanged(QPoint position) |
[since 6.11] valueAxis : QValue3DAxis*
Incluye un eje de valores adicional para la serie. Si se especifica un eje, la serie se ajustará a los valores mínimo y máximo de dicho eje.
Esta enumeración se introdujo en Qt 6.11.
Funciones de acceso:
| QValue3DAxis * | valueAxis() const |
| void | setValueAxis(QValue3DAxis *axis) |
| void | resetValueAxis() |
Señal de notificación:
| void | valueAxisChanged(QValue3DAxis *axis) |
[since 6.9] valueColoringEnabled : bool
Utiliza el valor indicado para colorear toda la barra según el degradado del rango
Esta propiedad permite colorear cada barra por separado según su valor y el degradado de rango indicado. Para utilizar esta propiedad, es necesario establecer la propiedad « QGraphsTheme::ColorStyle » en « QGraphsTheme::ColorStyle::RangeGradient ».
Esta enumeración se introdujo en Qt 6.9.
Funciones de acceso:
| bool | isValueColoringEnabled() const |
| void | setValueColoringEnabled(bool enabled) |
Señal de notificador:
| void | valueColoringEnabledChanged(bool enabled) |
Véase también QGraphsTheme::ColorStyle::RangeGradient.
Documentación de funciones miembro
[explicit] QBar3DSeries::QBar3DSeries(QObject *parent = nullptr)
Crea una serie de gráficos de barras en 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.
[override virtual noexcept] QBar3DSeries::~QBar3DSeries()
Elimina una serie de barras en 3D.
void QBar3DSeries::clearArray()
Borra la matriz existente.
void QBar3DSeries::clearRow(qsizetype rowIndex)
Borra la fila existente en la matriz según el « rowIndex » indicado.
[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 Q3DGraphsWidgetItem::clearSelection().
void QBar3DSeries::setSelectedBar(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 borrará 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 ` Q3DGraphsWidgetItem::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.