Scatter3DSeries QML Type
Representa una serie de datos en un gráfico de dispersión 3D. Más...
| Import Statement: | import QtGraphs |
| In C++: | QScatter3DSeries |
| Inherits: | |
| Inherited By: |
- Lista de todos los miembros, incluidos los heredados
- Scatter3DSeries es parte de Qt Graphs QML Types for 3D.
Propiedades
- baseColor : color
- baseGradient : Gradient
- colorStyle : GraphsTheme.ColorStyle
- dataArray : ScatterDataArray
- dataProxy : ScatterDataProxy
- invalidSelectionIndex : qsizetype
- itemLabel : string
- itemLabelFormat : string
- itemLabelVisible : bool
- itemSize : real
- lightingMode : Abstract3DSeries.LightingMode
(since 6.10) - mesh : Abstract3DSeries.Mesh
- meshRotation : quaternion
- meshSmooth : bool
- multiHighlightColor : color
- multiHighlightGradient : Gradient
- name : string
- selectedItem : qsizetype
- singleHighlightColor : color
- singleHighlightGradient : Gradient
- type : Abstract3DSeries.SeriesType
- userDefinedMesh : string
- visible : bool
Señales
- baseColorChanged(color color)
- baseGradientChanged(Gradient gradient)
- colorStyleChanged(GraphsTheme.ColorStyle style)
- dataArrayChanged(ScatterDataArray array)
- dataProxyChanged(ScatterDataProxy proxy)
- itemLabelChanged(string label)
- itemLabelFormatChanged(string format)
- itemLabelVisibilityChanged(bool visible)
- itemSizeChanged(float size)
- lightingModeChanged(Abstract3DSeries.LightingMode lightingMode)
(since 6.10) - meshChanged(Abstract3DSeries.Mesh mesh)
- meshRotationChanged(quaternion rotation)
- meshSmoothChanged(bool enabled)
- multiHighlightColorChanged(color color)
- multiHighlightGradientChanged(Gradient gradient)
- nameChanged(string name)
- selectedItemChanged(qsizetype index)
- singleHighlightColorChanged(color color)
- singleHighlightGradientChanged(Gradient gradient)
- splineColorChanged(color color)
- splineKnottingChanged(real knotting)
- splineLoopingChanged(bool looping)
- splineResolutionChanged(int resolution)
- splineTensionChanged(real tension)
- splineVisibilityChanged(bool visible)
- userDefinedMeshChanged(string fileName)
- visibilityChanged(bool visible)
Métodos
- void setMeshAxisAndAngle(vector3d axis, real angle)
Descripción detallada
Este tipo gestiona los elementos visuales específicos de la serie, así como los datos de la serie (a través de un proxy de datos).
Scatter3DSeries soporta las siguientes etiquetas de formato para itemLabelFormat:
| @xTitle | Título del eje x |
| @yTitle | Título del eje y |
| @zTitle | Título del eje z |
| @etiquetax | Valor del elemento formateado utilizando el formato del eje x. Para obtener más información, consulte labelFormat. |
| @yEtiqueta | Valor del elemento formateado utilizando el formato del eje y. Para más información, consulte labelFormat. |
| @zEtiqueta | Valor del elemento formateado utilizando el formato del eje z. Para más información, consulte labelFormat. |
| @nombreSerie | Nombre de la serie |
Para una descripción más completa, véase QScatter3DSeries.
Véase también Qt Graphs Manejo de datos con 3D.
Documentación de propiedades
baseColor : color
El color base de la serie.
Véase también colorStyle y GraphsTheme.seriesColors.
baseGradient : Gradient
El gradiente base de la serie.
Véase también colorStyle.
colorStyle : GraphsTheme.ColorStyle
El estilo de color de la serie.
Véase también GraphsTheme.ColorStyle.
dataArray : ScatterDataArray
Mantiene la referencia a la matriz de datos.
dataArrayChanged La señal se emite cuando se establece la matriz de datos, a menos que newDataArray sea idéntica a la anterior.
Nota: Antes de hacer nada con respecto a la matriz de datos, debe crearse una serie para el proxy correspondiente.
dataProxy : ScatterDataProxy
Establece el proxy de datos activo. La serie asume la propiedad de cualquier proxy que se le asigne y elimina cualquier proxy previamente asignado cuando se añade uno nuevo. El proxy no puede ser nulo ni estar asignado a otra serie.
invalidSelectionIndex : qsizetype
Una propiedad constante que proporciona un índice inválido para la selección. Este índice se establece en la propiedad selectedItem para borrar la selección de esta serie.
Véase también GraphsItem3D::clearSelection().
itemLabel : string [read-only]
La etiqueta formateada del elemento. Si no hay ningún elemento seleccionado o el elemento seleccionado no es visible, devuelve una cadena vacía.
Véase también itemLabelFormat.
itemLabelFormat : string
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.
Véase también Bar3DSeries, Scatter3DSeries, y Surface3DSeries.
itemLabelVisible : bool
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.
Véase también itemLabelFormat y itemLabel.
itemSize : real
Establece el tamaño del elemento para la serie. El tamaño debe estar entre 0.0 y 1.0. Establecer el tamaño en 0.0 hace que el tamaño del elemento se escale automáticamente basándose en el número total de elementos de todas las series del gráfico. El valor predeterminado es 0.0.
lightingMode : Abstract3DSeries.LightingMode [since 6.10]
El modo de iluminación de los elementos de la serie. El valor por defecto es QAbstract3DSeries::LightingMode::Shaded
Esta propiedad se introdujo en Qt 6.10.
Véase también QAbstract3DSeries::LightingMode.
mesh : Abstract3DSeries.Mesh
La malla de los elementos de la serie, o el puntero de selección en caso de Surface3DSeries. Si la malla es Abstract3DSeries.Mesh.UserDefined, también debe establecerse la propiedad userDefinedMesh para que los elementos se representen correctamente. El valor por defecto depende del tipo de gráfico.
Véase también QAbstract3DSeries::Mesh.
meshRotation : quaternion
La rotación de la malla que se aplica a todos los elementos de la serie. La rotación debe ser un cuaternión normalizado. Para los tipos de series que admiten la rotación específica de un elemento, las rotaciones se multiplican entre sí. Bar3DSeries ignora cualquier rotación que no sea alrededor del eje y. Surface3DSeries aplica la rotación sólo al puntero de selección. Por defecto sin rotación.
meshSmooth : bool
Si true, se utilizan versiones suavizadas de las mallas predefinidas establecidas mediante la propiedad mesh. Esta propiedad no afecta a las mallas personalizadas utilizadas cuando la malla se establece en Abstract3DSeries.Mesh.UserDefined. Por defecto es false.
multiHighlightColor : color
El color de resaltado de múltiples elementos de la serie.
Véase también colorStyle y GraphsTheme.multiHighlightColor.
multiHighlightGradient : Gradient
El gradiente de resaltado de múltiples elementos de la serie.
Véase también colorStyle y GraphsTheme.multiHighlightGradient.
name : string
El nombre de la serie. Puede utilizarse en formato de etiqueta de artículo con la etiqueta @seriesName.
Véase también itemLabelFormat.
selectedItem : qsizetype
El elemento seleccionado en el índice de la matriz de datos de la serie. Sólo se puede seleccionar un elemento a la vez. Para borrar la selección de esta serie, se establece invalidSelectionIndex como índice. Si se añade esta serie a un gráfico, éste puede ajustar la selección según la interacción del usuario o si deja de ser válida. La selección de un elemento en otra serie añadida también borrará la selección. Eliminar elementos de la serie o insertar elementos en ella antes del elemento seleccionado ajustará la selección de modo que el mismo elemento permanecerá seleccionado.
Véase también GraphsItem3D::clearSelection().
singleHighlightColor : color
El color de resaltado de cada elemento de la serie.
Véase también colorStyle y GraphsTheme.singleHighlightColor.
singleHighlightGradient : Gradient
El gradiente de resaltado de un único elemento de la serie.
Véase también colorStyle y GraphsTheme.singleHighlightGradient.
type : Abstract3DSeries.SeriesType [read-only]
El tipo de la serie. Uno de los valores de QAbstract3DSeries::SeriesType.
userDefinedMesh : string
El nombre de archivo para una malla personalizada definida por el usuario para objetos que se utiliza cuando mesh es Abstract3DSeries.Mesh.UserDefined.
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.
visible : bool
La visibilidad de la serie. Si false, la serie no se muestra.
Documentación de la señal
baseColorChanged(color color)
Esta señal se emite cuando baseColor cambia a color.
Nota: El controlador correspondiente es onBaseColorChanged.
baseGradientChanged(Gradient gradient)
Esta señal se emite cuando baseGradient cambia a gradient.
Nota: El controlador correspondiente es onBaseGradientChanged.
colorStyleChanged(GraphsTheme.ColorStyle style)
Esta señal se emite cuando colorStyle cambia a style.
Nota: El controlador correspondiente es onColorStyleChanged.
dataArrayChanged(ScatterDataArray array)
Esta señal se emite cuando dataArray cambia a array.
Nota: El controlador correspondiente es onDataArrayChanged.
dataProxyChanged(ScatterDataProxy proxy)
Esta señal se emite cuando dataProxy cambia a proxy.
Nota: El controlador correspondiente es onDataProxyChanged.
itemLabelChanged(string label)
Esta señal se emite cuando itemLabel cambia a label.
Nota: El controlador correspondiente es onItemLabelChanged.
itemLabelFormatChanged(string format)
Esta señal se emite cuando itemLabelFormat cambia a format.
Nota: El controlador correspondiente es onItemLabelFormatChanged.
itemLabelVisibilityChanged(bool visible)
Esta señal se emite cuando itemLabelVisibility cambia a visible.
Nota: El manejador correspondiente es onItemLabelVisibilityChanged.
itemSizeChanged(float size)
Esta señal se emite cuando itemSize cambia a size.
Nota: El controlador correspondiente es onItemSizeChanged.
[since 6.10] lightingModeChanged(Abstract3DSeries.LightingMode lightingMode)
Esta señal se emite cuando lightingMode cambia a lightingMode.
Nota: El manejador correspondiente es onLightingModeChanged.
Esta señal se introdujo en Qt 6.10.
meshChanged(Abstract3DSeries.Mesh mesh)
Esta señal se emite cuando mesh cambia a mesh.
Nota: El controlador correspondiente es onMeshChanged.
meshRotationChanged(quaternion rotation)
Esta señal se emite cuando meshRotation cambia a rotation.
Nota: El controlador correspondiente es onMeshRotationChanged.
meshSmoothChanged(bool enabled)
Esta señal se emite cuando meshSmooth cambia a enabled.
Nota: El controlador correspondiente es onMeshSmoothChanged.
multiHighlightColorChanged(color color)
Esta señal se emite cuando multiHighlightColor cambia a color.
Nota: El controlador correspondiente es onMultiHighlightColorChanged.
multiHighlightGradientChanged(Gradient gradient)
Esta señal se emite cuando multiHighlightGradient cambia a gradient.
Nota: El controlador correspondiente es onMultiHighlightGradientChanged.
nameChanged(string name)
Esta señal se emite cuando name cambia a name.
Nota: El controlador correspondiente es onNameChanged.
selectedItemChanged(qsizetype index)
Esta señal se emite cuando selectedItem cambia a index.
Nota: El controlador correspondiente es onSelectedItemChanged.
singleHighlightColorChanged(color color)
Esta señal se emite cuando singleHighlightColor cambia a color.
Nota: El controlador correspondiente es onSingleHighlightColorChanged.
singleHighlightGradientChanged(Gradient gradient)
Esta señal se emite cuando singleHighlightGradient cambia a gradient.
Nota: El controlador correspondiente es onSingleHighlightGradientChanged.
splineColorChanged(color color)
Esta señal se emite cuando splineColor cambia a color.
Nota: El manejador correspondiente es onSplineColorChanged.
splineKnottingChanged(real knotting)
Esta señal se emite cuando splineKnotting cambia a knotting.
Nota: El manejador correspondiente es onSplineKnottingChanged.
splineLoopingChanged(bool looping)
Esta señal se emite cuando splineLooping cambia a looping.
Nota: El manejador correspondiente es onSplineLoopingChanged.
splineResolutionChanged(int resolution)
Esta señal se emite cuando splineResolution cambia a resolution.
Nota: El manejador correspondiente es onSplineResolutionChanged.
splineTensionChanged(real tension)
Esta señal se emite cuando splineTension cambia a tension.
Nota: El manejador correspondiente es onSplineTensionChanged.
splineVisibilityChanged(bool visible)
Esta señal se emite cuando splineVisible cambia a visible.
Nota: El manejador correspondiente es onSplineVisibilityChanged.
userDefinedMeshChanged(string fileName)
Esta señal se emite cuando userDefinedMesh cambia a fileName.
Nota: El controlador correspondiente es onUserDefinedMeshChanged.
visibilityChanged(bool visible)
Esta señal se emite cuando la visibilidad de la serie cambia a visible.
Nota: El manejador correspondiente es onVisibilityChanged.
Documentación del método
void setMeshAxisAndAngle(vector3d axis, real angle)
Una función práctica para construir un cuaternión de rotación de malla a partir de axis y angle.
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.
