En esta página

QAbstract3DSeries Class

La clase QAbstract3DSeries es una clase base para todas las series de datos 3D. Más información...

Encabezado: #include <QAbstract3DSeries>
CMake: find_package(Qt6 REQUIRED COMPONENTS Graphs)
target_link_libraries(mytarget PRIVATE Qt6::Graphs)
qmake: QT += graphs
En QML: Abstract3DSeries
Heredado de: QObject
Heredado por:

QBar3DSeries, QScatter3DSeries y QSurface3DSeries

Tipos públicos

enum class LightingMode { Shaded, Unshaded }
enum class Mesh { UserDefined, Bar, Cube, Pyramid, Cone, …, Point }
enum class SeriesType { None, Bar, Scatter, Surface }

Propiedades

Funciones públicas

virtual ~QAbstract3DSeries() override
QColor baseColor() const
QLinearGradient baseGradient() const
QGraphsTheme::ColorStyle colorStyle() const
bool isItemLabelVisible() const
bool isMeshSmooth() const
bool isVisible() const
QString itemLabel()
QString itemLabelFormat() const
QAbstract3DSeries::LightingMode lightingMode() const
QAbstract3DSeries::Mesh mesh() const
QQuaternion meshRotation() const
QColor multiHighlightColor() const
QLinearGradient multiHighlightGradient() const
QString name() const
void setBaseColor(QColor color)
void setBaseGradient(const QLinearGradient &gradient)
void setColorStyle(QGraphsTheme::ColorStyle style)
void setItemLabelFormat(const QString &format)
void setItemLabelVisible(bool visible)
void setLightingMode(QAbstract3DSeries::LightingMode lightingMode)
void setMesh(QAbstract3DSeries::Mesh mesh)
void setMeshAxisAndAngle(QVector3D axis, float angle)
void setMeshRotation(const QQuaternion &rotation)
void setMeshSmooth(bool enable)
void setMultiHighlightColor(QColor color)
void setMultiHighlightGradient(const QLinearGradient &gradient)
void setName(const QString &name)
void setSingleHighlightColor(QColor color)
void setSingleHighlightGradient(const QLinearGradient &gradient)
void setUserDefinedMesh(const QString &fileName)
void setVisible(bool visible)
QColor singleHighlightColor() const
QLinearGradient singleHighlightGradient() const
QAbstract3DSeries::SeriesType type() const
QString userDefinedMesh() const

Señales

void baseColorChanged(QColor color)
void baseGradientChanged(const QLinearGradient &gradient)
void colorStyleChanged(QGraphsTheme::ColorStyle style)
void itemLabelChanged(const QString &label)
void itemLabelFormatChanged(const QString &format)
void itemLabelVisibleChanged(bool visible)
void lightingModeChanged(QAbstract3DSeries::LightingMode lightingMode)
void meshChanged(QAbstract3DSeries::Mesh mesh)
void meshRotationChanged(const QQuaternion &rotation)
void meshSmoothChanged(bool enabled)
void multiHighlightColorChanged(QColor color)
void multiHighlightGradientChanged(const QLinearGradient &gradient)
void nameChanged(const QString &name)
void singleHighlightColorChanged(QColor color)
void singleHighlightGradientChanged(const QLinearGradient &gradient)
void userDefinedMeshChanged(const QString &fileName)
void visibleChanged(bool visible)

Descripción detallada

Existen clases heredadas para cada tipo de serie compatible: QBar3DSeries, QScatter3DSeries y QSurface3DSeries.

Para obtener más información, consulta «Qt Graphs: Manejo de datos con 3D».

Documentación sobre los tipos de miembros

enum class QAbstract3DSeries::LightingMode

Modos de iluminación predefinidos

ConstanteValorDescripción
QAbstract3DSeries::LightingMode::Shaded0Los gráficos responden a la iluminación en tiempo real
QAbstract3DSeries::LightingMode::Unshaded-1Los gráficos no responden a la iluminación en tiempo real

enum class QAbstract3DSeries::Mesh

Tipos de malla predefinidos. No todos los estilos son compatibles con todos los tipos de gráficos.

ConstanteValorDescripción
QAbstract3DSeries::Mesh::UserDefined0Malla definida por el usuario, configurada mediante la propiedad « QAbstract3DSeries::userDefinedMesh ».
QAbstract3DSeries::Mesh::Bar1Barra rectangular básica.
QAbstract3DSeries::Mesh::Cube2Cubo básico.
QAbstract3DSeries::Mesh::Pyramid3Pirámide de cuatro caras.
QAbstract3DSeries::Mesh::Cone4Cono básico.
QAbstract3DSeries::Mesh::Cylinder5Cilindro básico.
QAbstract3DSeries::Mesh::BevelBar6Barra rectangular ligeramente biselada (redondeada).
QAbstract3DSeries::Mesh::BevelCube7Cubo ligeramente biselado (redondeado).
QAbstract3DSeries::Mesh::Sphere8Esfera.
QAbstract3DSeries::Mesh::Minimal9La malla 3D mínima: una pirámide triangular. Solo se puede utilizar con Q3DScatterWidgetItem.
QAbstract3DSeries::Mesh::Arrow10Flecha que apunta hacia arriba.
QAbstract3DSeries::Mesh::Point11Punto 2D. Solo se puede utilizar con Q3DScatterWidgetItem. Las sombras no afectan a este estilo. El estilo de color QGraphsTheme::ColorStyle::ObjectGradient no es compatible con este estilo.

enum class QAbstract3DSeries::SeriesType

Tipo de serie.

ConstanteValorDescripción
QAbstract3DSeries::SeriesType::None0Sin tipo de serie.
QAbstract3DSeries::SeriesType::Bar1Tipo de serie para « Q3DBarsWidgetItem ».
QAbstract3DSeries::SeriesType::Scatter2Tipo de serie para Q3DScatterWidgetItem.
QAbstract3DSeries::SeriesType::Surface3Tipo de serie para « Q3DSurfaceWidgetItem ».

Documentación de la propiedad

baseColor : QColor

Esta propiedad contiene el color base de la serie.

Funciones de acceso:

QColor baseColor() const
void setBaseColor(QColor color)

Señal de notificación:

void baseColorChanged(QColor color)

Véase también colorStyle y QGraphsTheme::seriesColors.

baseGradient : QLinearGradient

Esta propiedad contiene el degradado base de la serie.

Funciones de acceso:

QLinearGradient baseGradient() const
void setBaseGradient(const QLinearGradient &gradient)

Señal de notificación:

void baseGradientChanged(const QLinearGradient &gradient)

Véase también colorStyle y QGraphsTheme::seriesGradients.

colorStyle : QGraphsTheme::ColorStyle

Esta propiedad define el estilo de color de la serie.

Funciones de acceso:

QGraphsTheme::ColorStyle colorStyle() const
void setColorStyle(QGraphsTheme::ColorStyle style)

Señal de notificación:

void colorStyleChanged(QGraphsTheme::ColorStyle style)

Véase también QGraphsTheme::ColorStyle.

[read-only] itemLabel : QString

Esta propiedad contiene la etiqueta del elemento formateada.

Si no hay ningún elemento seleccionado o si el elemento seleccionado no está visible, devuelve una cadena vacía.

Funciones de acceso:

QString itemLabel()

Señal de notificación:

void itemLabelChanged(const QString &label)

Véase también itemLabelFormat.

itemLabelFormat : QString

Esta propiedad contiene el formato de etiqueta para los elementos de datos de esta serie.

Este formato se utiliza para las etiquetas de elementos individuales, por ejemplo, cuando se selecciona un elemento. La forma en que se interpreta el formato depende del tipo de serie.

Funciones de acceso:

QString itemLabelFormat() const
void setItemLabelFormat(const QString &format)

Señal de notificación:

void itemLabelFormatChanged(const QString &format)

Véase también QBar3DSeries, QScatter3DSeries y QSurface3DSeries.

itemLabelVisible : bool

Esta propiedad determina la visibilidad de las etiquetas de los elementos en el gráfico.

Si true, las etiquetas de los elementos se dibujan como etiquetas flotantes en el gráfico. De lo contrario, no se dibujan. Para mostrar la etiqueta del elemento en un control externo, esta propiedad se establece en false. El valor por defecto es true.

Funciones de acceso:

bool isItemLabelVisible() const
void setItemLabelVisible(bool visible)

Señal de notificación:

void itemLabelVisibleChanged(bool visible)

Véase también itemLabelFormat y itemLabel.

[since 6.10] lightingMode : QAbstract3DSeries::LightingMode

Esta propiedad almacena el modo de iluminación de la serie

Esta enumeración se introdujo en Qt 6.10.

Funciones de acceso:

QAbstract3DSeries::LightingMode lightingMode() const
void setLightingMode(QAbstract3DSeries::LightingMode lightingMode)

Señal de notificación:

void lightingModeChanged(QAbstract3DSeries::LightingMode lightingMode)

Véase también LightingMode.

mesh : QAbstract3DSeries::Mesh

Esta propiedad contiene la malla de los elementos de la serie.

En el caso de « QSurface3DSeries », esta propiedad contiene el puntero de selección.

Si la malla es de tipo `MeshUserDefined`, también debe establecerse la propiedad ` userDefinedMesh ` para que los elementos se representen correctamente. El valor por defecto depende del tipo de gráfico.

Funciones de acceso:

QAbstract3DSeries::Mesh mesh() const
void setMesh(QAbstract3DSeries::Mesh mesh)

Señal del notificador:

void meshChanged(QAbstract3DSeries::Mesh mesh)

meshRotation : QQuaternion

Esta propiedad contiene la rotación de la malla que se aplica a todos los elementos de la serie.

La rotación debe ser un valor normalizado QQuaternion. En los tipos de serie que admiten rotación específica por elemento, las rotaciones se multiplican entre sí. QBar3DSeries ignora cualquier rotación que no sea alrededor del eje y. QSurface3DSeries aplica la rotación únicamente al puntero de selección. Por defecto, no hay rotación.

Funciones de acceso:

QQuaternion meshRotation() const
void setMeshRotation(const QQuaternion &rotation)

Señal del notificador:

void meshRotationChanged(const QQuaternion &rotation)

meshSmooth : bool

Esta propiedad determina si se utilizan versiones suavizadas de las mallas predefinidas.

Si se establece « true », se utilizan las versiones suavizadas definidas mediante la propiedad « mesh ». Esta propiedad no afecta a las mallas personalizadas que se utilizan cuando la malla se establece en «MeshUserDefined». El valor por defecto es « false ».

Funciones de acceso:

bool isMeshSmooth() const
void setMeshSmooth(bool enable)

Señal de notificador:

void meshSmoothChanged(bool enabled)

multiHighlightColor : QColor

Esta propiedad determina el color de resaltado de varios elementos de la serie.

Funciones de acceso:

QColor multiHighlightColor() const
void setMultiHighlightColor(QColor color)

Señal de notificación:

void multiHighlightColorChanged(QColor color)

Véase también colorStyle y QGraphsTheme::multiHighlightColor.

multiHighlightGradient : QLinearGradient

Esta propiedad contiene el degradado de resaltado de varios elementos de la serie.

Funciones de acceso:

QLinearGradient multiHighlightGradient() const
void setMultiHighlightGradient(const QLinearGradient &gradient)

Señal de notificación:

void multiHighlightGradientChanged(const QLinearGradient &gradient)

Véase también colorStyle y QGraphsTheme::multiHighlightGradient.

name : QString

Esta propiedad contiene el nombre de la serie.

El nombre de la serie se puede utilizar en el formato de etiqueta de elemento con la etiqueta @seriesName.

Funciones de acceso:

QString name() const
void setName(const QString &name)

Señal de notificación:

void nameChanged(const QString &name)

Véase también itemLabelFormat.

singleHighlightColor : QColor

Esta propiedad establece el color de resaltado de un único elemento de la serie.

Funciones de acceso:

QColor singleHighlightColor() const
void setSingleHighlightColor(QColor color)

Señal de notificación:

void singleHighlightColorChanged(QColor color)

Véase también colorStyle y QGraphsTheme::singleHighlightColor.

singleHighlightGradient : QLinearGradient

Esta propiedad contiene el degradado de resaltado de un único elemento de la serie.

Funciones de acceso:

QLinearGradient singleHighlightGradient() const
void setSingleHighlightGradient(const QLinearGradient &gradient)

Señal de notificación:

void singleHighlightGradientChanged(const QLinearGradient &gradient)

Véase también colorStyle y QGraphsTheme::singleHighlightGradient.

[read-only] type : const QAbstract3DSeries::SeriesType

Esta propiedad contiene el tipo de la serie.

Funciones de acceso:

QAbstract3DSeries::SeriesType type() const

userDefinedMesh : QString

Esta propiedad contiene el nombre de archivo de una malla personalizada definida por el usuario para los objetos.

La malla personalizada se utiliza cuando mesh tiene el valor MeshUserDefined.

Nota: El archivo debe estar en el formato de malla de QtQuick3D. Utiliza la herramienta de conversión balsam para crear una malla a partir de otros formatos de modelos 3D.

Funciones de acceso:

QString userDefinedMesh() const
void setUserDefinedMesh(const QString &fileName)

Señal de notificación:

void userDefinedMeshChanged(const QString &fileName)

visible : bool

Esta propiedad determina la visibilidad de la serie.

Si esta propiedad es « false », la serie no se muestra. El valor por defecto es « true ».

Funciones de acceso:

bool isVisible() const
void setVisible(bool visible)

Señal de notificación:

void visibleChanged(bool visible)

Documentación de las funciones de miembro

[override virtual noexcept] QAbstract3DSeries::~QAbstract3DSeries()

Elimina la serie 3D abstracta.

[invokable] void QAbstract3DSeries::setMeshAxisAndAngle(QVector3D axis, float angle)

Una función de conveniencia para construir un cuaternión de rotación de malla a partir de axis y angle.

Nota: Esta función se puede invocar a través del sistema de metaobjetos y desde QML. Véase Q_INVOKABLE.

Véase también meshRotation.

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