Theme3D QML Type
Un estilo visual para gráficos. Más información...
| Import Statement: | import QtDataVisualization 1.12 |
| Since: | QtDataVisualization 1.0 |
| In C++: | Q3DTheme |
| Status: | Deprecated |
Este tipo está obsoleto. Recomendamos encarecidamente no utilizarlo en código nuevo.
Propiedades
- ambientLightStrength : real
- backgroundColor : color
- backgroundEnabled : bool
- baseColors : list<ThemeColor>
- baseGradients : list<ColorGradient>
- colorStyle : Theme3D.ColorStyle
- font : font
- gridEnabled : bool
- gridLineColor : color
- highlightLightStrength : real
- labelBackgroundColor : color
- labelBackgroundEnabled : bool
- labelBorderEnabled : bool
- labelTextColor : color
- lightColor : color
- lightStrength : real
- multiHighlightColor : color
- multiHighlightGradient : ColorGradient
- singleHighlightColor : color
- singleHighlightGradient : ColorGradient
- type : Theme3D.Theme
- windowColor : color
Descripción detallada
Este tipo se utiliza para especificar propiedades visuales que afectan a todo el gráfico. Existen varios temas integrados que pueden utilizarse tal cual o modificarse libremente.
Las siguientes propiedades pueden sobrescribirse utilizando las propiedades ` Abstract3DSeries ` para configurarlas explícitamente en la serie: ` baseColors`, ` baseGradients` y ` colorStyle`.
Se pueden crear temas desde cero utilizando el valor de la enumeración « Theme3D.ThemeUserDefined ».
Tema predeterminado
La siguiente tabla enumera las propiedades controladas por los temas y los valores predeterminados para « Theme3D.ThemeUserDefined ».
| Propiedad | Valor predeterminado |
|---|---|
| ambientLightStrength | 0,25 |
| backgroundColor | «black». Para obtener más información, consulta color. |
| backgroundEnabled | true |
| baseColors | «black» |
| baseGradients | QLinearGradient. Prácticamente totalmente negro. |
| colorStyle | ColorStyleUniform |
| font | font |
| gridEnabled | true |
| gridLineColor | «blanco» |
| highlightLightStrength | 7,5 |
| labelBackgroundColor | «gris» |
| labelBackgroundEnabled | true |
| labelBorderEnabled | true |
| labelTextColor | «blanco» |
| lightColor | «blanco» |
| lightStrength | 5,0 |
| multiHighlightColor | «azul» |
| multiHighlightGradient | QLinearGradient. Prácticamente todo negro. |
| singleHighlightColor | «rojo» |
| singleHighlightGradient | QLinearGradient. Prácticamente todo negro. |
| windowColor | «negro» |
Ejemplos de uso
Uso de un tema integrado sin modificaciones:
Scatter3D {
...
theme: Theme3D { type: Theme3D.ThemeRetro }
...
}Uso de un tema integrado y modificación de algunas propiedades:
Bars3D {
...
theme: Theme3D {
type: Theme3D.ThemeRetro
labelBorderEnabled: true
font.pointSize: 35
labelBackgroundEnabled: false
}
...
}Uso de un tema definido por el usuario:
Surface3D {
...
theme: Theme3D {
ambientLightStrength: 0.5
backgroundColor: "red"
backgroundEnabled: true
baseColor: "blue"
colorStyle: Theme3D.ColorStyleUniform
font.family: "Lucida Handwriting"
font.pointSize: 35
gridEnabled: false
gridLineColor: "black"
highlightLightStrength: 0.5
labelBackgroundColor: "black"
labelBackgroundEnabled: true
labelBorderEnabled: false
labelTextColor: "white"
lightColor: "yellow"
lightStrength: 0.4
multiHighlightColor: "green"
singleHighlightColor: "darkRed"
windowColor: "white"
}
...
}Para las enumeraciones de Theme3D, consulta Q3DTheme::ColorStyle y Q3DTheme::Theme.
Documentación de propiedades
ambientLightStrength : real
La intensidad de la luz ambiental para todo el gráfico. Este valor determina la uniformidad y el brillo con los que se muestran los colores en todo el gráfico, independientemente de la posición de la luz. El valor debe estar comprendido entre 0.0 y 1.0.
backgroundColor : color
El color del fondo del gráfico.
backgroundEnabled : bool
Establece si el fondo se dibuja utilizando el valor de « backgroundColor ».
baseColors : list<ThemeColor>
La lista de colores base que se utilizarán para todos los objetos del gráfico, serie por serie. Si hay más series que colores, la lista de colores se repite y vuelve a empezar por el primer color de la lista. No tiene efecto inmediato si colorStyle no es Theme3D.ColorStyleUniform.
Esto se puede anular estableciendo explícitamente ` Abstract3DSeries.baseColor ` en la serie.
baseGradients : list<ColorGradient>
La lista de degradados básicos que se utilizarán para todos los objetos del gráfico, serie por serie. Si hay más series que degradados, la lista de degradados se repite y vuelve a empezar por el primer degradado de la lista.
No tiene ningún efecto inmediato si ` colorStyle ` es ` Theme3D.ColorStyleUniform`.
Este valor se puede anular estableciendo explícitamente ` Abstract3DSeries.baseGradient ` en la serie.
colorStyle : Theme3D.ColorStyle
El estilo de los colores del gráfico. Uno de los valores de la enumeración « Q3DTheme::ColorStyle ».
Este valor se puede anular estableciendo Abstract3DSeries.colorStyle de forma explícita en la serie.
Véase también Q3DTheme::ColorStyle.
font : font
Establece la fuente que se utilizará para las etiquetas.
gridEnabled : bool
Determina si se dibujan las líneas de la cuadrícula. Este valor afecta a todas las líneas de la cuadrícula.
gridLineColor : color
El color de las líneas de la cuadrícula.
Nota: La transparencia no es compatible y provocará un comportamiento indefinido.
highlightLightStrength : real
La intensidad de la luz especular para los objetos seleccionados. El valor debe estar comprendido entre 0.0 y 10.0.
labelBackgroundColor : color
El color de fondo de las etiquetas. No tiene ningún efecto si la opción « labelBackgroundEnabled » está configurada como « false ».
labelBackgroundEnabled : bool
Define si la etiqueta se dibuja con un fondo que utiliza el valor « labelBackgroundColor » (incluido el alfa) o con un fondo totalmente transparente. Las etiquetas con fondo se dibujan con el mismo tamaño en cada eje, basándose en la etiqueta más larga, y el texto se centra en ellas. Las etiquetas sin fondo se dibujan tal cual y se alinean a la izquierda o a la derecha en función de su posición en el gráfico.
labelBorderEnabled : bool
Determina si se dibujan los bordes de las etiquetas que tienen fondo. No tiene ningún efecto si la opción « labelBackgroundEnabled » está establecida en « false ».
labelTextColor : color
El color de la fuente utilizada para las etiquetas.
lightColor : color
El color de la luz ambiental y especular definido en Scene3D.
lightStrength : real
La intensidad de la luz especular para todo el gráfico. El valor debe estar comprendido entre 0.0 y 10.0.
Este valor afecta a la luz especificada en Scene3D.
multiHighlightColor : color
El color de resaltado para los objetos seleccionados. Se utiliza si en « selectionMode » se ha activado la opción « AbstractGraph3D.SelectionRow » o « AbstractGraph3D.SelectionColumn ».
Nota: No se admitela transparencia y su uso dará lugar a un comportamiento indefinido.
multiHighlightGradient : ColorGradient
selectionMode El degradado de resaltado para los objetos seleccionados. Se utiliza si se ha activado la opción « AbstractGraph3D.SelectionRow » con el indicador « » o « AbstractGraph3D.SelectionColumn ».
Nota: No se admitela transparencia y dará lugar a un comportamiento indefinido.
singleHighlightColor : color
El color de resaltado de un objeto seleccionado. Se utiliza si ` selectionMode ` tiene activada la opción « AbstractGraph3D.SelectionItem ».
Nota: No se admitela transparencia y dará lugar a un comportamiento indefinido.
singleHighlightGradient : ColorGradient
El degradado de resaltado de un objeto seleccionado. Se utiliza si en « selectionMode » se ha activado la opción « AbstractGraph3D.SelectionItem ».
Nota: No se admitela transparencia y provocará un comportamiento indefinido.
type : Theme3D.Theme
El tipo del tema. Si no se especifica ningún tipo, el tipo por defecto es « Theme3D.ThemeUserDefined ». Si se cambia el tipo de tema una vez creado el elemento, todas las demás propiedades del tema se ajustarán a lo que especifique el tema predefinido. Al cambiar el tipo del tema activo del gráfico, también se restablecerán todas las series asociadas para que utilicen el nuevo tema.
windowColor : color
El color de la ventana de la aplicación en la que se dibuja el gráfico.
© 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.