En esta página

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

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

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()`:

@rowTitleTítulo del eje de filas
@colTitleTítulo del eje de columnas
@valueTitleTí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.
@rowLabelEtiqueta del eje de filas
@colLabelEtiqueta del eje de columnas
@valueLabelValor del elemento formateado según el formato del eje de valores asociado al gráfico. Para obtener más información, consulta QValue3DAxis::labelFormat.
@seriesNameNombre 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.