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 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

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

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

@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 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.