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: |
- Lista de todos los miembros, incluidos los heredados
- QAbstract3DSeries forma parte de las clases C++ deQt Graphs para 3D.
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
| Constante | Valor | Descripción |
|---|---|---|
QAbstract3DSeries::LightingMode::Shaded | 0 | Los gráficos responden a la iluminación en tiempo real |
QAbstract3DSeries::LightingMode::Unshaded | -1 | Los 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.
| Constante | Valor | Descripción |
|---|---|---|
QAbstract3DSeries::Mesh::UserDefined | 0 | Malla definida por el usuario, configurada mediante la propiedad « QAbstract3DSeries::userDefinedMesh ». |
QAbstract3DSeries::Mesh::Bar | 1 | Barra rectangular básica. |
QAbstract3DSeries::Mesh::Cube | 2 | Cubo básico. |
QAbstract3DSeries::Mesh::Pyramid | 3 | Pirámide de cuatro caras. |
QAbstract3DSeries::Mesh::Cone | 4 | Cono básico. |
QAbstract3DSeries::Mesh::Cylinder | 5 | Cilindro básico. |
QAbstract3DSeries::Mesh::BevelBar | 6 | Barra rectangular ligeramente biselada (redondeada). |
QAbstract3DSeries::Mesh::BevelCube | 7 | Cubo ligeramente biselado (redondeado). |
QAbstract3DSeries::Mesh::Sphere | 8 | Esfera. |
QAbstract3DSeries::Mesh::Minimal | 9 | La malla 3D mínima: una pirámide triangular. Solo se puede utilizar con Q3DScatterWidgetItem. |
QAbstract3DSeries::Mesh::Arrow | 10 | Flecha que apunta hacia arriba. |
QAbstract3DSeries::Mesh::Point | 11 | Punto 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.
| Constante | Valor | Descripción |
|---|---|---|
QAbstract3DSeries::SeriesType::None | 0 | Sin tipo de serie. |
QAbstract3DSeries::SeriesType::Bar | 1 | Tipo de serie para « Q3DBarsWidgetItem ». |
QAbstract3DSeries::SeriesType::Scatter | 2 | Tipo de serie para Q3DScatterWidgetItem. |
QAbstract3DSeries::SeriesType::Surface | 3 | Tipo 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.