Bar3DSeries QML Type (Uncreatable)
Representa una serie de datos en un gráfico de barras en 3D. Más...
| Import Statement: | import QtGraphs |
| In C++: | QBar3DSeries |
| Inherits: |
Nota: Se trata de un tipo no creable. No se puede instanciar en QML.
- Lista de todos los miembros, incluidos los heredados
- Bar3DSeries forma parte de los tipos QML para 3D deQt Graphs .
Propiedades
- baseColor : color
- baseGradient : Gradient
- colorStyle : GraphsTheme.ColorStyle
- columnLabels : list
- dataArray : BarDataArray
- dataProxy : BarDataProxy
- invalidSelectionPosition : point
- itemLabel : string
- itemLabelFormat : string
- itemLabelVisible : bool
- lightingMode : Abstract3DSeries.LightingMode
(since 6.10) - mesh : Abstract3DSeries.Mesh
- meshAngle : real
- meshRotation : quaternion
- meshSmooth : bool
- multiHighlightColor : color
- multiHighlightGradient : Gradient
- name : string
- rowColors : list<Color>
- rowLabels : list
- selectedBar : point
- singleHighlightColor : color
- singleHighlightGradient : Gradient
- type : Abstract3DSeries.SeriesType
- userDefinedMesh : string
- visible : bool
Señales
- baseColorChanged(color color)
- baseGradientChanged(Gradient gradient)
- colorStyleChanged(GraphsTheme.ColorStyle style)
- columnLabelsChanged()
- dataArrayChanged(BarDataArray array)
- dataProxyChanged(BarDataProxy proxy)
- itemLabelChanged(string label)
- itemLabelFormatChanged(string format)
- itemLabelVisibilityChanged(bool visible)
- lightingModeChanged(Abstract3DSeries.LightingMode lightingMode)
(since 6.10) - meshAngleChanged(real angle)
- meshChanged(Abstract3DSeries.Mesh mesh)
- meshRotationChanged(quaternion rotation)
- meshSmoothChanged(bool enabled)
- multiHighlightColorChanged(color color)
- multiHighlightGradientChanged(Gradient gradient)
- nameChanged(string name)
- rowColorsChanged(list<color> rowcolors)
- rowLabelsChanged()
- selectedBarChanged(point position)
- singleHighlightColorChanged(color color)
- singleHighlightGradientChanged(Gradient gradient)
- 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 misma (a través de un proxy de datos).
Bar3DSeries admite las siguientes etiquetas de formato para itemLabelFormat:
| @rowTitle | Título del eje de filas |
| @colTitle | Título del eje de columnas |
| @valueTitle | Título del eje de valores |
| @rowIdx | Índice de la fila visible. Localizado según la configuración regional del gráfico. |
| @colIdx | Índice de la columna visible. Localizado según la configuración regional del gráfico. |
| @rowLabel | Etiqueta del eje de filas |
| @colLabel | Etiqueta del eje de columnas |
| @valueLabel | Valor del elemento formateado según el formato del eje de valores asociado al gráfico. Para obtener más información, consulta labelFormat. |
| @seriesName | Nombre de la serie |
| %<especificación de formato> | Valor del elemento en el formato especificado. Se formatea siguiendo las mismas reglas que en labelFormat. |
Para obtener una descripción más completa, consulte QBar3DSeries.
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 cromático de la serie.
Véase también GraphsTheme.ColorStyle.
columnLabels : list
Las etiquetas de columna opcionales para la matriz. Los índices de esta matriz coinciden con los índices de columna de las filas. Si la lista es más corta que la fila más larga, no se asignarán etiquetas a todas las columnas.
dataArray : BarDataArray
Contiene la referencia de la matriz de datos.
dataArrayChanged Se emite una señal cuando se establece el conjunto de datos, a menos que « newDataArray » sea idéntico al anterior.
Nota: Antes de realizar cualquier operación relacionada con `dataArray`, se debe crear una serie para el proxy correspondiente.
dataProxy : BarDataProxy
El proxy de datos activo. La serie asume la propiedad de cualquier proxy que se le asigne y elimina cualquier proxy establecido anteriormente cuando se añade uno nuevo. El proxy no puede ser nulo ni estar asignado a otra serie.
invalidSelectionPosition : point [read-only]
Una propiedad constante que proporciona una posición no válida para la selección. Esta posición se asigna a la propiedad selectedBar para borrar la selección de esta serie.
Véase también GraphsItem3D.clearSelection().
itemLabel : string [read-only]
La etiqueta del elemento con formato. Si no hay ningún elemento seleccionado o si el elemento seleccionado no está 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 un solo elemento, por ejemplo, cuando se selecciona un elemento. La forma en que se interpreta el 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. 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.
Véase también « itemLabelFormat » y « itemLabel ».
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 el caso de Surface3DSeries. Si la malla es Abstract3DSeries.Mesh.UserDefined, también debe configurarse 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.
meshAngle : real
Una propiedad de conveniencia que permite definir el ángulo de rotación de la serie en grados.
Nota: Al leer esta propiedad, se calcula a partir del valor de ` Abstract3DSeries.meshRotation ` utilizando precisión de punto flotante y siempre devuelve un valor comprendido entre cero y 360 grados.
Véase también Abstract3DSeries.meshRotation.
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. En los tipos de serie que admiten rotaciones específicas para cada elemento, las rotaciones se multiplican entre sí. Bar3DSeries ignora cualquier rotación que no sea alrededor del eje y. Surface3DSeries aplica la rotación únicamente al puntero de selección. Por defecto, no hay rotación.
meshSmooth : bool
Si se establece true, se utilizan versiones suavizadas de las mallas predefinidas configuradas mediante la propiedad mesh. Esta propiedad no afecta a las mallas personalizadas que se utilizan cuando la malla se establece en Abstract3DSeries.Mesh.UserDefined. El valor por defecto es false.
multiHighlightColor : color
El color de resaltado de varios elementos de la serie.
Véase también colorStyle y GraphsTheme.multiHighlightColor.
multiHighlightGradient : Gradient
El degradado de resaltado de varios elementos de la serie.
Véase también colorStyle y GraphsTheme.multiHighlightGradient.
name : string
El nombre de la serie. Se puede utilizar en el formato de etiqueta de artículo con la etiqueta @seriesName.
Véase también itemLabelFormat.
rowColors : list<Color>
Esta propiedad permite dibujar las filas de la serie en diferentes colores. Para utilizar esta propiedad, es necesario establecer la propiedad « GraphsTheme.colorStyle » en « Uniform ».
Nota: Si se establece la propiedad y se cambia el tema, la lista rowColors no se borra automáticamente.
Véase también QGraphsTheme::ColorStyle::Uniform.
rowLabels : list
Las etiquetas de fila opcionales para la matriz. Los índices de esta matriz coinciden con los índices de fila de la matriz de datos. Si la lista es más corta que el número de filas, no se asignarán etiquetas a todas las filas.
selectedBar : point
La barra seleccionada de la serie.
La posición de la barra seleccionada se especifica como una fila y una columna en la matriz de datos de la serie.
Solo se puede seleccionar una barra a la vez.
Para deseleccionar esta serie, asigna « invalidSelectionPosition » como posición.
Si esta serie se añade a un gráfico, este puede ajustar la selección en función de la interacción del usuario o si deja de ser válida. Seleccionar una barra de otra serie añadida también borrará la selección.
Si se eliminan o se insertan filas en la serie antes de la fila de la barra seleccionada, la selección se ajustará de modo que la misma barra siga seleccionada.
Véase también GraphsItem3D.clearSelection().
singleHighlightColor : color
El color de resaltado de un solo elemento de la serie.
Véase también colorStyle y GraphsTheme.singleHighlightColor.
singleHighlightGradient : Gradient
El artículo destacado con degradado 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 del archivo de una malla personalizada definida por el usuario para objetos, que se utiliza cuando se ejecuta « mesh », es Abstract3DSeries.Mesh.UserDefined.
Nota: El archivo debe estar en el formato de malla de QtQuick3D. Utiliza la herramienta de conversión de balsam para crear una malla a partir de otros formatos de modelos 3D.
visible : bool
La visibilidad de la serie. Si es « false », la serie no se muestra.
Documentación de Signal
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.
columnLabelsChanged()
Esta señal se emite cuando cambian las etiquetas de las columnas.
Nota: El controlador correspondiente es onColumnLabelsChanged.
dataArrayChanged(BarDataArray array)
Esta señal se emite cuando dataArray cambia a array.
Nota: El controlador correspondiente es onDataArrayChanged.
dataProxyChanged(BarDataProxy 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 controlador correspondiente es « onItemLabelVisibilityChanged ».
[since 6.10] lightingModeChanged(Abstract3DSeries.LightingMode lightingMode)
Esta señal se emite cuando lightingMode cambia a lightingMode.
Nota: El controlador correspondiente es onLightingModeChanged.
Esta señal se introdujo en Qt 6.10.
meshAngleChanged(real angle)
Esta señal se emite cuando meshAngle cambia a angle.
Nota: El controlador correspondiente es onMeshAngleChanged.
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.
rowColorsChanged(list<color> rowcolors)
Esta señal se emite cuando rowColors cambia a rowcolors.
Nota: El controlador correspondiente es onRowColorsChanged.
rowLabelsChanged()
Esta señal se emite cuando cambian las etiquetas de las filas.
Nota: El controlador correspondiente es onRowLabelsChanged.
selectedBarChanged(point position)
Esta señal se emite cuando selectedBar cambia a position.
Nota: El controlador correspondiente es onSelectedBarChanged.
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.
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 controlador 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.