En esta página

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`.

Ejemplos de uso

Creación de un tema integrado sin modificaciones:

Q3DTheme *theme = new Q3DTheme(Q3DTheme::ThemeQt);

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:

Q3DBars *graph = new Q3DBars();
graph->activeTheme()->setType(Q3DTheme::ThemePrimaryColors);
graph->activeTheme()->setBaseColor(Qt::red);
graph->activeTheme()->setSingleHighlightColor(Qt::yellow);

Documentación sobre tipos de miembros

enum Q3DTheme::ColorStyle

Estilos de color.

ConstanteValorDescripción
Q3DTheme::ColorStyleUniform0Los objetos se representan en un único color. El color utilizado se especifica en las propiedades « baseColors », « singleHighlightColor » y « multiHighlightColor ».
Q3DTheme::ColorStyleObjectGradient1Los 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::ColorStyleRangeGradient2Los 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.

ConstanteValorDescripción
Q3DTheme::ThemeQt0Un tema claro con el verde como color base.
Q3DTheme::ThemePrimaryColors1Un tema claro con el amarillo como color base.
Q3DTheme::ThemeDigia2Un tema claro con el gris como color de base.
Q3DTheme::ThemeStoneMoss3Un tema medio-oscuro con el amarillo como color base.
Q3DTheme::ThemeArmyBlue4Un tema medio claro con el azul como color base.
Q3DTheme::ThemeRetro5Un tema medio claro con el marrón como color base.
Q3DTheme::ThemeEbony6Un tema oscuro con el blanco como color base.
Q3DTheme::ThemeIsabelle7Un tema oscuro con el amarillo como color base.
Q3DTheme::ThemeUserDefined8Un 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.