QAbstract3DSeries Class
La clase QAbstract3DSeries es una clase base para todas las series de datos 3D. Más...
| Cabecera: | #include <QAbstract3DSeries> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Graphs)target_link_libraries(mytarget PRIVATE Qt6::Graphs) |
| qmake: | QT += graphs |
| En QML: | Abstract3DSeries |
| Hereda de: | QObject |
| Heredado de: |
- Lista de todos los miembros, incluyendo los heredados
- QAbstract3DSeries es parte de Qt Graphs C++ Classes for 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 soportada: QBar3DSeries, QScatter3DSeries, y QSurface3DSeries.
Para más información, consulte Qt Graphs Manejo de datos con 3D.
Documentación de 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. Todos los estilos no son utilizables con todos los tipos de gráficos.
| Constante | Valor | Descripción |
|---|---|---|
QAbstract3DSeries::Mesh::UserDefined | 0 | Malla definida por el usuario, establecida 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 lados. |
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. Utilizable sólo con Q3DScatterWidgetItem. |
QAbstract3DSeries::Mesh::Arrow | 10 | Flecha hacia arriba. |
QAbstract3DSeries::Mesh::Point | 11 | Punto 2D. Utilizable sólo 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 la 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 propiedades
baseColor : QColor
Esta propiedad contiene el color base de la serie.
Funciones de acceso:
| QColor | baseColor() const |
| void | setBaseColor(QColor color) |
Señal del notificador:
| void | baseColorChanged(QColor color) |
Véase también colorStyle y QGraphsTheme::seriesColors.
baseGradient : QLinearGradient
Esta propiedad contiene el gradiente base de la serie.
Funciones de acceso:
| QLinearGradient | baseGradient() const |
| void | setBaseGradient(const QLinearGradient &gradient) |
Señal del notificador:
| void | baseGradientChanged(const QLinearGradient &gradient) |
Véase también colorStyle y QGraphsTheme::seriesGradients.
colorStyle : QGraphsTheme::ColorStyle
Esta propiedad contiene el estilo de color para la serie.
Funciones de acceso:
| QGraphsTheme::ColorStyle | colorStyle() const |
| void | setColorStyle(QGraphsTheme::ColorStyle style) |
Señal del notificador:
| void | colorStyleChanged(QGraphsTheme::ColorStyle style) |
Véase también QGraphsTheme::ColorStyle.
[read-only] itemLabel : QString
Esta propiedad contiene la etiqueta formateada del elemento.
Si no hay ningún elemento seleccionado o el elemento seleccionado no es visible, devuelve una cadena vacía.
Funciones de acceso:
| QString | itemLabel() |
Señal del notificador:
| 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 etiquetas de elementos individuales, por ejemplo, cuando se selecciona un elemento. La interpretación del formato depende del tipo de serie.
Funciones de acceso:
| QString | itemLabelFormat() const |
| void | setItemLabelFormat(const QString &format) |
Señal del notificador:
| void | itemLabelFormatChanged(const QString &format) |
Véase también QBar3DSeries, QScatter3DSeries, y QSurface3DSeries.
itemLabelVisible : bool
Esta propiedad mantiene 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. En caso contrario, no se dibujan. Para mostrar la etiqueta de elemento en un control externo, esta propiedad se establece en false. Por defecto es true.
Funciones de acceso:
| bool | isItemLabelVisible() const |
| void | setItemLabelVisible(bool visible) |
Señal del notificador:
| void | itemLabelVisibleChanged(bool visible) |
Véase también itemLabelFormat y itemLabel.
[since 6.10] lightingMode : QAbstract3DSeries::LightingMode
Esta propiedad contiene el modo de iluminación de la serie
Esta propiedad se introdujo en Qt 6.10.
Funciones de acceso:
| QAbstract3DSeries::LightingMode | lightingMode() const |
| void | setLightingMode(QAbstract3DSeries::LightingMode lightingMode) |
Señal del notificador:
| void | lightingModeChanged(QAbstract3DSeries::LightingMode lightingMode) |
Véase también LightingMode.
mesh : QAbstract3DSeries::Mesh
Esta propiedad contiene la malla de los elementos de la serie.
Para QSurface3DSeries, esta propiedad contiene el puntero de selección.
Si la malla es MeshUserDefined, entonces la propiedad userDefinedMesh también debe estar establecida para que los elementos se muestren 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 una normalizada QQuaternion. Para aquellos tipos de series que soportan la rotación específica de un elemento, las rotaciones se multiplican juntas. QBar3DSeries ignora cualquier rotación que no sea alrededor del eje y. QSurface3DSeries aplica la rotación sólo al puntero de selección. Por defecto sin 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 true, se utilizan las versiones suavizadas establecidas mediante la propiedad mesh. Esta propiedad no afecta a las mallas personalizadas utilizadas cuando la malla está definida como MeshUserDefined. 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 contiene el color de resaltado de múltiples elementos de la serie.
Funciones de acceso:
| QColor | multiHighlightColor() const |
| void | setMultiHighlightColor(QColor color) |
Señal del notificador:
| void | multiHighlightColorChanged(QColor color) |
Véase también colorStyle y QGraphsTheme::multiHighlightColor.
multiHighlightGradient : QLinearGradient
Esta propiedad contiene el gradiente de resaltado de múltiples elementos de la serie.
Funciones de acceso:
| QLinearGradient | multiHighlightGradient() const |
| void | setMultiHighlightGradient(const QLinearGradient &gradient) |
Señal del notificador:
| 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 puede utilizarse en formato de etiqueta de artículo con la etiqueta @seriesName.
Funciones de acceso:
| QString | name() const |
| void | setName(const QString &name) |
Señal del notificador:
| void | nameChanged(const QString &name) |
Véase también itemLabelFormat.
singleHighlightColor : QColor
Esta propiedad contiene el color de resaltado de cada elemento de la serie.
Funciones de acceso:
| QColor | singleHighlightColor() const |
| void | setSingleHighlightColor(QColor color) |
Señal del notificador:
| void | singleHighlightColorChanged(QColor color) |
Véase también colorStyle y QGraphsTheme::singleHighlightColor.
singleHighlightGradient : QLinearGradient
Esta propiedad contiene el gradiente de resaltado de un único elemento de la serie.
Funciones de acceso:
| QLinearGradient | singleHighlightGradient() const |
| void | setSingleHighlightGradient(const QLinearGradient &gradient) |
Señal del notificador:
| 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 es MeshUserDefined.
Nota: El archivo debe estar en el formato de malla QtQuick3D. Utilice 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 del notificador:
| void | userDefinedMeshChanged(const QString &fileName) |
visible : bool
Esta propiedad contiene la visibilidad de la serie.
Si esta propiedad es false, la serie no se muestra. Por defecto es true.
Funciones de acceso:
| bool | isVisible() const |
| void | setVisible(bool visible) |
Señal del notificador:
| void | visibleChanged(bool visible) |
Documentación de la función miembro
[override virtual noexcept] QAbstract3DSeries::~QAbstract3DSeries()
Borra 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 puede invocarse 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.
