QAbstract3DSeries Class
La clase QAbstract3DSeries es una clase base para todas las series de datos. Más...
| Cabecera: | #include <QAbstract3DSeries> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS DataVisualization)target_link_libraries(mytarget PRIVATE Qt6::DataVisualization) |
| qmake: | QT += datavisualization |
| Desde: | QtDataVisualization 1.0 |
| En QML: | Abstract3DSeries |
| Hereda de: | QObject |
| Heredado de: |
Tipos públicos
| enum | Mesh { MeshUserDefined, MeshBar, MeshCube, MeshPyramid, MeshCone, …, MeshPoint } |
| enum | SeriesType { SeriesTypeNone, SeriesTypeBar, SeriesTypeScatter, SeriesTypeSurface } |
Propiedades
|
|
Funciones públicas
| virtual | ~QAbstract3DSeries() |
| QColor | baseColor() const |
| QLinearGradient | baseGradient() const |
| Q3DTheme::ColorStyle | colorStyle() const |
| bool | isItemLabelVisible() const |
| bool | isMeshSmooth() const |
| bool | isVisible() const |
| QString | itemLabel() const |
| QString | itemLabelFormat() const |
| QAbstract3DSeries::Mesh | mesh() const |
| QQuaternion | meshRotation() const |
| QColor | multiHighlightColor() const |
| QLinearGradient | multiHighlightGradient() const |
| QString | name() const |
| void | setBaseColor(const QColor &color) |
| void | setBaseGradient(const QLinearGradient &gradient) |
| void | setColorStyle(Q3DTheme::ColorStyle style) |
| void | setItemLabelFormat(const QString &format) |
| void | setItemLabelVisible(bool visible) |
| void | setMesh(QAbstract3DSeries::Mesh mesh) |
| void | setMeshAxisAndAngle(const QVector3D &axis, float angle) |
| void | setMeshRotation(const QQuaternion &rotation) |
| void | setMeshSmooth(bool enable) |
| void | setMultiHighlightColor(const QColor &color) |
| void | setMultiHighlightGradient(const QLinearGradient &gradient) |
| void | setName(const QString &name) |
| void | setSingleHighlightColor(const 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(const QColor &color) |
| void | baseGradientChanged(const QLinearGradient &gradient) |
| void | colorStyleChanged(Q3DTheme::ColorStyle style) |
| void | itemLabelChanged(const QString &label) |
| void | itemLabelFormatChanged(const QString &format) |
| void | itemLabelVisibilityChanged(bool visible) |
| void | meshChanged(QAbstract3DSeries::Mesh mesh) |
| void | meshRotationChanged(const QQuaternion &rotation) |
| void | meshSmoothChanged(bool enabled) |
| void | multiHighlightColorChanged(const QColor &color) |
| void | multiHighlightGradientChanged(const QLinearGradient &gradient) |
| void | nameChanged(const QString &name) |
| void | singleHighlightColorChanged(const QColor &color) |
| void | singleHighlightGradientChanged(const QLinearGradient &gradient) |
| void | userDefinedMeshChanged(const QString &fileName) |
| void | visibilityChanged(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 Data Visualization Manejo de Datos.
Documentación de tipos de miembros
enum QAbstract3DSeries::Mesh
Tipos de malla predefinidos. Todos los estilos no son utilizables con todos los tipos de visualización.
| Constante | Valor | Descripción |
|---|---|---|
QAbstract3DSeries::MeshUserDefined | 0 | Malla definida por el usuario, establecida mediante la propiedad QAbstract3DSeries::userDefinedMesh. |
QAbstract3DSeries::MeshBar | 1 | Barra rectangular básica. |
QAbstract3DSeries::MeshCube | 2 | Cubo básico. |
QAbstract3DSeries::MeshPyramid | 3 | Pirámide de cuatro lados. |
QAbstract3DSeries::MeshCone | 4 | Cono básico. |
QAbstract3DSeries::MeshCylinder | 5 | Cilindro básico. |
QAbstract3DSeries::MeshBevelBar | 6 | Barra rectangular ligeramente biselada (redondeada). |
QAbstract3DSeries::MeshBevelCube | 7 | Cubo ligeramente biselado (redondeado). |
QAbstract3DSeries::MeshSphere | 8 | Esfera. |
QAbstract3DSeries::MeshMinimal | 9 | La malla 3D mínima: una pirámide triangular. Utilizable sólo con Q3DScatter. |
QAbstract3DSeries::MeshArrow | 10 | Flecha hacia arriba. |
QAbstract3DSeries::MeshPoint | 11 | Punto 2D. Utilizable sólo con Q3DScatter. Las sombras no afectan a este estilo. El estilo de color Q3DTheme::ColorStyleObjectGradient no es compatible con este estilo. |
enum QAbstract3DSeries::SeriesType
Tipo de la serie.
| Constante | Valor | Descripción |
|---|---|---|
QAbstract3DSeries::SeriesTypeNone | 0 | Sin tipo de serie. |
QAbstract3DSeries::SeriesTypeBar | 1 | Tipo de serie para Q3DBars. |
QAbstract3DSeries::SeriesTypeScatter | 2 | Tipo de serie para Q3DScatter. |
QAbstract3DSeries::SeriesTypeSurface | 4 | Tipo de serie para Q3DSurface. |
Documentación de propiedades
baseColor : QColor
Esta propiedad contiene el color base de la serie.
Funciones de acceso:
| QColor | baseColor() const |
| void | setBaseColor(const QColor &color) |
Señal del notificador:
| void | baseColorChanged(const QColor &color) |
Véase también colorStyle y Q3DTheme::baseColors.
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 Q3DTheme::baseGradients.
colorStyle : Q3DTheme::ColorStyle
Esta propiedad contiene el estilo de color para la serie.
Funciones de acceso:
| Q3DTheme::ColorStyle | colorStyle() const |
| void | setColorStyle(Q3DTheme::ColorStyle style) |
Señal del notificador:
| void | colorStyleChanged(Q3DTheme::ColorStyle style) |
Véase también Q3DTheme::ColorStyle.
[read-only, since QtDataVisualization 1.1] 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.
Esta propiedad se introdujo en QtDataVisualization 1.1.
Funciones de acceso:
| QString | itemLabel() const |
Señal de 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: QBar3DSeries, QScatter3DSeries, QSurface3DSeries.
Funciones de acceso:
| QString | itemLabelFormat() const |
| void | setItemLabelFormat(const QString &format) |
Señal del notificador:
| void | itemLabelFormatChanged(const QString &format) |
[since QtDataVisualization 1.1] 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.
Esta propiedad se introdujo en QtDataVisualization 1.1.
Funciones de acceso:
| bool | isItemLabelVisible() const |
| void | setItemLabelVisible(bool visible) |
Señal de notificador:
| void | itemLabelVisibilityChanged(bool visible) |
Véase también itemLabelFormat y itemLabel.
mesh : 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 indica 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 se establece en MeshUserDefined. Por defecto es false.
Funciones de acceso:
| bool | isMeshSmooth() const |
| void | setMeshSmooth(bool enable) |
Señal del 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(const QColor &color) |
Señal del notificador:
| void | multiHighlightColorChanged(const QColor &color) |
Véase también colorStyle y Q3DTheme::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 Q3DTheme::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(const QColor &color) |
Señal del notificador:
| void | singleHighlightColorChanged(const QColor &color) |
Véase también colorStyle y Q3DTheme::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 Q3DTheme::singleHighlightGradient.
[read-only] type : const 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 formato Wavefront OBJ e incluir vértices, normales y UVs. También debe estar en triángulos.
Funciones de acceso:
| QString | userDefinedMesh() const |
| void | setUserDefinedMesh(const QString &fileName) |
Notificador de señal:
| 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 | visibilityChanged(bool visible) |
Documentación de la función miembro
[virtual noexcept] QAbstract3DSeries::~QAbstract3DSeries()
Borra la serie 3D abstracta.
[invokable] void QAbstract3DSeries::setMeshAxisAndAngle(const 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.
