Q3DTheme Class
La clase Q3DTheme proporciona un estilo visual para los gráficos. Más información...
| Encabezado: | #include <Q3DTheme> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS DataVisualization) target_link_libraries(mytarget PRIVATE Qt6::DataVisualization) |
| qmake: | QT += datavisualization |
| Desde: | QtDataVisualization 1.0 |
| En QML: | Theme3D |
| Heredado de: | QObject |
| Estado: | Obsoleta |
Esta clase está obsoleta. Se desaconseja encarecidamente su uso en código nuevo.
Tipos públicos
| enum | ColorStyle { ColorStyleUniform, ColorStyleObjectGradient, ColorStyleRangeGradient } |
| enum | Theme { ThemeQt, ThemePrimaryColors, ThemeDigia, ThemeStoneMoss, ThemeArmyBlue, …, ThemeUserDefined } |
Propiedades
|
|
Funciones públicas
| Q3DTheme(QObject *parent = nullptr) | |
| Q3DTheme(Q3DTheme::Theme themeType, QObject *parent = nullptr) | |
| virtual | ~Q3DTheme() |
| float | ambientLightStrength() const |
| QColor | backgroundColor() const |
| QList<QColor> | baseColors() const |
| QList<QLinearGradient> | baseGradients() const |
| Q3DTheme::ColorStyle | colorStyle() const |
| QFont | font() const |
| QColor | gridLineColor() const |
| float | highlightLightStrength() const |
| bool | isBackgroundEnabled() const |
| bool | isGridEnabled() const |
| bool | isLabelBackgroundEnabled() const |
| bool | isLabelBorderEnabled() const |
| QColor | labelBackgroundColor() const |
| QColor | labelTextColor() const |
| QColor | lightColor() const |
| float | lightStrength() const |
| QColor | multiHighlightColor() const |
| QLinearGradient | multiHighlightGradient() const |
| void | setAmbientLightStrength(float strength) |
| void | setBackgroundColor(const QColor &color) |
| void | setBackgroundEnabled(bool enabled) |
| void | setBaseColors(const QList<QColor> &colors) |
| void | setBaseGradients(const QList<QLinearGradient> &gradients) |
| void | setColorStyle(Q3DTheme::ColorStyle style) |
| void | setFont(const QFont &font) |
| void | setGridEnabled(bool enabled) |
| void | setGridLineColor(const QColor &color) |
| void | setHighlightLightStrength(float strength) |
| void | setLabelBackgroundColor(const QColor &color) |
| void | setLabelBackgroundEnabled(bool enabled) |
| void | setLabelBorderEnabled(bool enabled) |
| void | setLabelTextColor(const QColor &color) |
| void | setLightColor(const QColor &color) |
| void | setLightStrength(float strength) |
| void | setMultiHighlightColor(const QColor &color) |
| void | setMultiHighlightGradient(const QLinearGradient &gradient) |
| void | setSingleHighlightColor(const QColor &color) |
| void | setSingleHighlightGradient(const QLinearGradient &gradient) |
| void | setType(Q3DTheme::Theme themeType) |
| void | setWindowColor(const QColor &color) |
| QColor | singleHighlightColor() const |
| QLinearGradient | singleHighlightGradient() const |
| Q3DTheme::Theme | type() const |
| QColor | windowColor() const |
Señales
| void | ambientLightStrengthChanged(float strength) |
| void | backgroundColorChanged(const QColor &color) |
| void | backgroundEnabledChanged(bool enabled) |
| void | baseColorsChanged(const QList<QColor> &colors) |
| void | baseGradientsChanged(const QList<QLinearGradient> &gradients) |
| void | colorStyleChanged(Q3DTheme::ColorStyle style) |
| void | fontChanged(const QFont &font) |
| void | gridEnabledChanged(bool enabled) |
| void | gridLineColorChanged(const QColor &color) |
| void | highlightLightStrengthChanged(float strength) |
| void | labelBackgroundColorChanged(const QColor &color) |
| void | labelBackgroundEnabledChanged(bool enabled) |
| void | labelBorderEnabledChanged(bool enabled) |
| void | labelTextColorChanged(const QColor &color) |
| void | lightColorChanged(const QColor &color) |
| void | lightStrengthChanged(float strength) |
| void | multiHighlightColorChanged(const QColor &color) |
| void | multiHighlightGradientChanged(const QLinearGradient &gradient) |
| void | singleHighlightColorChanged(const QColor &color) |
| void | singleHighlightGradientChanged(const QLinearGradient &gradient) |
| void | typeChanged(Q3DTheme::Theme themeType) |
| void | windowColorChanged(const QColor &color) |
Descripción detallada
Especifica las propiedades visuales que afectan a todo el gráfico. Hay varios temas integrados que se pueden utilizar tal cual o modificar libremente.
Las siguientes propiedades pueden sobrescribirse utilizando las propiedades ` QAbstract3DSeries ` para establecerlas explícitamente en la serie: ` baseColors`, ` baseGradients` y ` colorStyle`.
Los temas se pueden crear desde cero utilizando el valor de la enumeración ThemeUserDefined. Al crear un tema con el constructor predeterminado se genera un nuevo tema definido por el usuario.
Tema predeterminado
La siguiente tabla enumera las propiedades controladas por los temas y los valores predeterminados para ` ThemeUserDefined`.
| Propiedad | Valor por defecto |
|---|---|
| ambientLightStrength | 0,25 |
| backgroundColor | Qt::black |
| backgroundEnabled | true |
| baseColors | Qt::black |
| baseGradients | QLinearGradient. Prácticamente todo negro. |
| colorStyle | ColorStyleUniform |
| font | QFont |
| gridEnabled | true |
| gridLineColor | Qt::white |
| highlightLightStrength | 7,5 |
| labelBackgroundColor | Qt::gray |
| labelBackgroundEnabled | true |
| labelBorderEnabled | true |
| labelTextColor | Qt::white |
| lightColor | Qt::white |
| lightStrength | 5,0 |
| multiHighlightColor | Qt::blue |
| multiHighlightGradient | QLinearGradient. Prácticamente totalmente negro. |
| singleHighlightColor | Qt::red |
| singleHighlightGradient | QLinearGradient. Prácticamente todo negro. |
| windowColor | Qt::black |
Ejemplos de uso
Creación de un tema integrado sin modificaciones:
Crear un tema integrado y modificar algunas propiedades:
Q3DTheme *theme = new Q3DTheme(Q3DTheme::ThemeQt);
theme->setBackgroundEnabled(false);
theme->setLabelBackgroundEnabled(false);Creación de un tema definido por el usuario:
Q3DTheme *theme = new Q3DTheme();
theme->setAmbientLightStrength(0.3f);
theme->setBackgroundColor(QColor(QRgb(0x99ca53)));
theme->setBackgroundEnabled(true);
theme->setBaseColor(QColor(QRgb(0x209fdf)));
theme->setColorStyle(Q3DTheme::ColorStyleUniform);
theme->setFont(QFont(QStringLiteral("Impact"), 35));
theme->setGridEnabled(true);
theme->setGridLineColor(QColor(QRgb(0x99ca53)));
theme->setHighlightLightStrength(7.0f);
theme->setLabelBackgroundColor(QColor(0xf6, 0xa6, 0x25, 0xa0));
theme->setLabelBackgroundEnabled(true);
theme->setLabelBorderEnabled(true);
theme->setLabelTextColor(QColor(QRgb(0x404044)));
theme->setLightColor(Qt::white);
theme->setLightStrength(6.0f);
theme->setMultiHighlightColor(QColor(QRgb(0x6d5fd5)));
theme->setSingleHighlightColor(QColor(QRgb(0xf6a625)));
theme->setWindowColor(QColor(QRgb(0xffffff)));Creación de un tema integrado y modificación de algunas propiedades una vez aplicado:
Documentación sobre tipos de miembros
enum Q3DTheme::ColorStyle
Estilos de color.
| Constante | Valor | Descripción |
|---|---|---|
Q3DTheme::ColorStyleUniform | 0 | Los objetos se representan en un único color. El color utilizado se especifica en las propiedades « baseColors », « singleHighlightColor » y « multiHighlightColor ». |
Q3DTheme::ColorStyleObjectGradient | 1 | Los objetos se colorean utilizando un degradado completo para cada uno de ellos, independientemente de su altura. El degradado utilizado se especifica en las propiedades baseGradients, singleHighlightGradient y multiHighlightGradient. |
Q3DTheme::ColorStyleRangeGradient | 2 | Los objetos se colorean utilizando una parte del degradado completo determinada por la altura del objeto y su posición en el eje Y. El degradado utilizado se especifica en las propiedades « baseGradients », « singleHighlightGradient » y « multiHighlightGradient ». |
enum Q3DTheme::Theme
Temas integrados.
| Constante | Valor | Descripción |
|---|---|---|
Q3DTheme::ThemeQt | 0 | Un tema claro con el verde como color base. |
Q3DTheme::ThemePrimaryColors | 1 | Un tema claro con el amarillo como color base. |
Q3DTheme::ThemeDigia | 2 | Un tema claro con el gris como color de base. |
Q3DTheme::ThemeStoneMoss | 3 | Un tema medio-oscuro con el amarillo como color base. |
Q3DTheme::ThemeArmyBlue | 4 | Un tema medio claro con el azul como color base. |
Q3DTheme::ThemeRetro | 5 | Un tema medio claro con el marrón como color base. |
Q3DTheme::ThemeEbony | 6 | Un tema oscuro con el blanco como color base. |
Q3DTheme::ThemeIsabelle | 7 | Un tema oscuro con el amarillo como color base. |
Q3DTheme::ThemeUserDefined | 8 | Un tema definido por el usuario. Para obtener más información, consulta Default Theme. |
Documentación de propiedades
ambientLightStrength : float
Esta propiedad determina la intensidad de la luz ambiental para todo el gráfico.
Este valor determina la uniformidad y el brillo con 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.0f y 1.0f.
Funciones de acceso:
| float | ambientLightStrength() const |
| void | setAmbientLightStrength(float strength) |
Señal de notificación:
| void | ambientLightStrengthChanged(float strength) |
backgroundColor : QColor
Esta propiedad determina el color del fondo del gráfico.
Funciones de acceso:
| QColor | backgroundColor() const |
| void | setBackgroundColor(const QColor &color) |
Señal de notificación:
| void | backgroundColorChanged(const QColor &color) |
backgroundEnabled : bool
Esta propiedad indica si el fondo está visible.
El fondo se dibuja utilizando el valor de « backgroundColor ».
Funciones de acceso:
| bool | isBackgroundEnabled() const |
| void | setBackgroundEnabled(bool enabled) |
Señal de notificador:
| void | backgroundEnabledChanged(bool enabled) |
baseColors : QList<QColor>
Esta propiedad contiene 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 reanuda y vuelve a empezar con el primer color de la lista.
No tiene ningún efecto inmediato si « colorStyle » no es « ColorStyleUniform ».
Este valor se puede anular estableciendo explícitamente el valor de « baseColor » en la serie.
Funciones de acceso:
| QList<QColor> | baseColors() const |
| void | setBaseColors(const QList<QColor> &colors) |
Señal de notificación:
| void | baseColorsChanged(const QList<QColor> &colors) |
baseGradients : QList<QLinearGradient>
Esta propiedad contiene 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 gradientes, la lista de gradientes se reanuda y vuelve a empezar con el primer gradiente de la lista
No tiene ningún efecto inmediato si ` colorStyle ` es ` ColorStyleUniform`.
Este valor se puede anular estableciendo explícitamente el ` baseGradient ` en la serie.
Funciones de acceso:
| QList<QLinearGradient> | baseGradients() const |
| void | setBaseGradients(const QList<QLinearGradient> &gradients) |
Señal de notificación:
| void | baseGradientsChanged(const QList<QLinearGradient> &gradients) |
colorStyle : ColorStyle
Esta propiedad define el estilo de los colores del gráfico.
Uno de los valores de la enumeración « ColorStyle ».
Este valor se puede anular estableciendo explícitamente colorStyle en la serie.
Funciones de acceso:
| Q3DTheme::ColorStyle | colorStyle() const |
| void | setColorStyle(Q3DTheme::ColorStyle style) |
Señal de notificación:
| void | colorStyleChanged(Q3DTheme::ColorStyle style) |
font : QFont
Esta propiedad especifica la fuente que se utilizará para las etiquetas.
Funciones de acceso:
| QFont | font() const |
| void | setFont(const QFont &font) |
Señal de notificación:
| void | fontChanged(const QFont &font) |
gridEnabled : bool
Esta propiedad determina si se dibujan las líneas de la cuadrícula.
Este valor afecta a todas las líneas de cuadrícula.
Funciones de acceso:
| bool | isGridEnabled() const |
| void | setGridEnabled(bool enabled) |
Señal de notificación:
| void | gridEnabledChanged(bool enabled) |
gridLineColor : QColor
Esta propiedad determina el color de las líneas de la cuadrícula.
Nota: No se admitela transparencia ; su uso provocará un comportamiento indefinido.
Funciones de acceso:
| QColor | gridLineColor() const |
| void | setGridLineColor(const QColor &color) |
Señal del notificador:
| void | gridLineColorChanged(const QColor &color) |
highlightLightStrength : float
Esta propiedad almacena la intensidad de la luz especular de los objetos seleccionados.
El valor debe estar comprendido entre 0.0f y 10.0f.
Funciones de acceso:
| float | highlightLightStrength() const |
| void | setHighlightLightStrength(float strength) |
Señal de notificación:
| void | highlightLightStrengthChanged(float strength) |
labelBackgroundColor : QColor
Esta propiedad determina el color de fondo de las etiquetas.
No tiene ningún efecto si « labelBackgroundEnabled » está establecido en « false ».
Funciones de acceso:
| QColor | labelBackgroundColor() const |
| void | setLabelBackgroundColor(const QColor &color) |
Señal de notificación:
| void | labelBackgroundColorChanged(const QColor &color) |
labelBackgroundEnabled : bool
Esta propiedad se mantiene tanto si la etiqueta se dibuja con un fondo de color como si se dibuja con un fondo totalmente transparente.
El valor de « labelBackgroundColor » (incluido el alfa) se utiliza para dibujar el fondo.
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 según su posición en el gráfico.
Funciones de acceso:
| bool | isLabelBackgroundEnabled() const |
| void | setLabelBackgroundEnabled(bool enabled) |
Señal de notificación:
| void | labelBackgroundEnabledChanged(bool enabled) |
labelBorderEnabled : bool
Esta propiedad determina si se dibujan los bordes de las etiquetas que tienen fondo.
No tiene ningún efecto si « labelBackgroundEnabled » está establecido en « false ».
Funciones de acceso:
| bool | isLabelBorderEnabled() const |
| void | setLabelBorderEnabled(bool enabled) |
Señal de notificación:
| void | labelBorderEnabledChanged(bool enabled) |
labelTextColor : QColor
Esta propiedad define el color de la fuente utilizada para las etiquetas.
Funciones de acceso:
| QColor | labelTextColor() const |
| void | setLabelTextColor(const QColor &color) |
Señal del notificador:
| void | labelTextColorChanged(const QColor &color) |
lightColor : QColor
Esta propiedad contiene el color de la luz ambiental y especular.
Este valor afecta a la luz especificada en Q3DScene.
Funciones de acceso:
| QColor | lightColor() const |
| void | setLightColor(const QColor &color) |
Señal de notificador:
| void | lightColorChanged(const QColor &color) |
lightStrength : float
Esta propiedad determina la intensidad de la luz especular para todo el gráfico.
El valor debe estar comprendido entre 0.0f y 10.0f.
Este valor afecta a la luz especificada en Q3DScene.
Funciones de acceso:
| float | lightStrength() const |
| void | setLightStrength(float strength) |
Señal de notificación:
| void | lightStrengthChanged(float strength) |
multiHighlightColor : QColor
Esta propiedad contiene el color de resaltado de los objetos seleccionados.
Se utiliza si en « selectionMode » se ha activado la opción « QAbstract3DGraph::SelectionRow » o « QAbstract3DGraph::SelectionColumn ».
Funciones de acceso:
| QColor | multiHighlightColor() const |
| void | setMultiHighlightColor(const QColor &color) |
Señal del notificador:
| void | multiHighlightColorChanged(const QColor &color) |
multiHighlightGradient : QLinearGradient
Esta propiedad almacena el degradado de resaltado de los objetos seleccionados.
Se utiliza si la propiedad « selectionMode » tiene activada la opción « QAbstract3DGraph::SelectionRow » o « QAbstract3DGraph::SelectionColumn ».
Funciones de acceso:
| QLinearGradient | multiHighlightGradient() const |
| void | setMultiHighlightGradient(const QLinearGradient &gradient) |
Señal de notificación:
| void | multiHighlightGradientChanged(const QLinearGradient &gradient) |
singleHighlightColor : QColor
Esta propiedad contiene el color de resaltado de un objeto seleccionado.
Se utiliza si « selectionMode » tiene activado el indicador « QAbstract3DGraph::SelectionItem ».
Funciones de acceso:
| QColor | singleHighlightColor() const |
| void | setSingleHighlightColor(const QColor &color) |
Señal de notificador:
| void | singleHighlightColorChanged(const QColor &color) |
singleHighlightGradient : QLinearGradient
Esta propiedad contiene el degradado de resaltado de un objeto seleccionado.
Se utiliza si en « selectionMode » se ha activado el indicador « QAbstract3DGraph::SelectionItem ».
Funciones de acceso:
| QLinearGradient | singleHighlightGradient() const |
| void | setSingleHighlightGradient(const QLinearGradient &gradient) |
Señal de notificación:
| void | singleHighlightGradientChanged(const QLinearGradient &gradient) |
type : Theme
Esta propiedad indica el tipo del tema.
El tipo se establece automáticamente al crear un tema, pero también se puede modificar posteriormente. Al cambiar el tipo de tema, todas las demás propiedades del tema pasarán a ser las que especifica el tema predefinido. Al cambiar el tipo de tema del tema activo del gráfico, también se restablecerán todas las series asociadas para que utilicen el nuevo tema.
Funciones de acceso:
| Q3DTheme::Theme | type() const |
| void | setType(Q3DTheme::Theme themeType) |
Señal de notificación:
| void | typeChanged(Q3DTheme::Theme themeType) |
windowColor : QColor
Esta propiedad contiene el color de la ventana de la aplicación en la que se dibuja el gráfico.
Funciones de acceso:
| QColor | windowColor() const |
| void | setWindowColor(const QColor &color) |
Señal de notificación:
| void | windowColorChanged(const QColor &color) |
Documentación de las funciones de miembro
[explicit] Q3DTheme::Q3DTheme(QObject *parent = nullptr)
Crea un nuevo tema de tipo ` ThemeUserDefined`. Se puede proporcionar un parámetro opcional ` parent `, que se pasa al constructor ` QObject `.
[explicit] Q3DTheme::Q3DTheme(Q3DTheme::Theme themeType, QObject *parent = nullptr)
Crea un nuevo tema con ` themeType`, que puede ser uno de los temas integrados de Theme. Se puede especificar un parámetro opcional ` parent `, que se pasa al constructor de ` QObject `.
[virtual noexcept] Q3DTheme::~Q3DTheme()
Echa por tierra el tema.
© 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.