QAbstract3DSeries Class
La clase `QAbstract3DSeries` es una clase base para todas las series de datos. Más información...
| Encabezado: | #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 |
| Heredado de: | QObject |
| Heredado por: | |
| Estado: | Obsoleto |
Esta clase está obsoleta. Recomendamos encarecidamente no utilizarla en código nuevo.
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 admitido: ` QBar3DSeries`, ` QScatter3DSeries` y ` QSurface3DSeries`.
Para obtener más información, consulta «Manejo de datos deQt Data Visualization ».
Documentación sobre los tipos de miembros
enum QAbstract3DSeries::Mesh
Tipos de malla predefinidos. No todos los estilos son compatibles con todos los tipos de visualización.
| Constante | Valor | Descripción |
|---|---|---|
QAbstract3DSeries::MeshUserDefined | 0 | Malla definida por el usuario, configurada 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 caras. |
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. Solo se puede utilizar con Q3DScatter. |
QAbstract3DSeries::MeshArrow | 10 | Flecha que apunta hacia arriba. |
QAbstract3DSeries::MeshPoint | 11 | Punto 2D. Solo se puede utilizar con Q3DScatter. Las sombras no afectan a este estilo. Este estilo no admite el estilo de color « Q3DTheme::ColorStyleObjectGradient ». |
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 de base de la serie.
Funciones de acceso:
| QColor | baseColor() const |
| void | setBaseColor(const QColor &color) |
Señal de notificación:
| void | baseColorChanged(const QColor &color) |
Véase también colorStyle y Q3DTheme::baseColors.
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 Q3DTheme::baseGradients.
colorStyle : Q3DTheme::ColorStyle
Esta propiedad define el estilo de color de la serie.
Funciones de acceso:
| Q3DTheme::ColorStyle | colorStyle() const |
| void | setColorStyle(Q3DTheme::ColorStyle style) |
Señal de notificación:
| void | colorStyleChanged(Q3DTheme::ColorStyle style) |
Véase también Q3DTheme::ColorStyle.
[read-only, since QtDataVisualization 1.1] itemLabel : QString
Esta propiedad contiene la etiqueta del elemento con el formato aplicado.
Si no hay ningún elemento seleccionado o si el elemento seleccionado no está visible, devuelve una cadena vacía.
Esta enumeración se introdujo en QtDataVisualization 1.1.
Funciones de acceso:
| QString | itemLabel() const |
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 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: QBar3DSeries, QScatter3DSeries, QSurface3DSeries.
Funciones de acceso:
| QString | itemLabelFormat() const |
| void | setItemLabelFormat(const QString &format) |
Señal de notificación:
| void | itemLabelFormatChanged(const QString &format) |
[since QtDataVisualization 1.1] itemLabelVisible : bool
Esta propiedad determina la visibilidad de las etiquetas de los elementos en el gráfico.
Si se establece en « 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 ».
Esta enumeración 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.
En el caso de QSurface3DSeries, esta propiedad contiene el puntero de selección.
Si la malla es de tip 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 de 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 de 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 está configurada 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 define el color de resaltado de varios elementos de la serie.
Funciones de acceso:
| QColor | multiHighlightColor() const |
| void | setMultiHighlightColor(const QColor &color) |
Señal de notificación:
| void | multiHighlightColorChanged(const QColor &color) |
Véase también colorStyle y Q3DTheme::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 Q3DTheme::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 notificador:
| 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(const QColor &color) |
Señal de notificación:
| void | singleHighlightColorChanged(const QColor &color) |
Véase también colorStyle y Q3DTheme::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 Q3DTheme::singleHighlightGradient.
[read-only] type : const SeriesType
Esta propiedad indica 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 formato Wavefront OBJ e incluir vértices, normales y coordenadas UV. Además, debe estar formado por triángulos.
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 del notificador:
| void | visibilityChanged(bool visible) |
Documentación de las funciones de miembro
[virtual noexcept] QAbstract3DSeries::~QAbstract3DSeries()
Elimina la serie abstracta en 3D.
[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 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.