En esta página

QGraphsTheme Class

La clase QGraphsTheme proporciona un estilo visual para los gráficos. Más información...

Encabezado: #include <QGraphsTheme>
CMake: find_package(Qt6 REQUIRED COMPONENTS Graphs)
target_link_libraries(mytarget PRIVATE Qt6::Graphs)
qmake: QT += graphs
En QML: GraphsTheme
Heredan de:QObject y QQmlParserStatus

Tipos públicos

enum class ColorScheme { Automatic, Light, Dark }
enum class ColorStyle { Uniform, ObjectGradient, RangeGradient }
enum class Theme { QtGreen, QtGreenNeon, MixSeries, OrangeSeries, YellowSeries, …, UserDefined }

Propiedades

Funciones públicas

QGraphsLine axisX() const
QFont axisXLabelFont() const
QGraphsLine axisY() const
QFont axisYLabelFont() const
QGraphsLine axisZ() const
QFont axisZLabelFont() const
QColor backgroundColor() const
QList<QColor> borderColors() const
qreal borderWidth() const
QGraphsTheme::ColorScheme colorScheme() const
QGraphsTheme::ColorStyle colorStyle() const
QGraphsLine grid() const
bool isBackgroundVisible() const
bool isGridVisible() const
bool isLabelBackgroundVisible() const
bool isLabelBorderVisible() const
bool isPlotAreaBackgroundVisible() const
QColor labelBackgroundColor() const
QFont labelFont() const
QColor labelTextColor() const
bool labelsVisible() const
QColor multiHighlightColor() const
QColor plotAreaBackgroundColor() const
QList<QColor> seriesColors() const
QList<QLinearGradient> seriesGradients() const
void setAxisX(const QGraphsLine &newAxisX)
void setAxisXLabelFont(const QFont &newAxisXLabelFont)
void setAxisY(const QGraphsLine &newAxisY)
void setAxisYLabelFont(const QFont &newAxisYLabelFont)
void setAxisZ(const QGraphsLine &newAxisZ)
void setAxisZLabelFont(const QFont &newAxisZLabelFont)
void setBackgroundColor(QColor newBackgroundColor)
void setBackgroundVisible(bool newBackgroundVisible)
void setBorderColors(const QList<QColor> &newBorderColors)
void setBorderWidth(qreal newBorderWidth)
void setColorScheme(QGraphsTheme::ColorScheme newColorScheme)
void setColorStyle(QGraphsTheme::ColorStyle newColorStyle)
void setGrid(const QGraphsLine &newGrid)
void setGridVisible(bool newGridVisibility)
void setLabelBackgroundColor(QColor newLabelBackgroundColor)
void setLabelBackgroundVisible(bool newLabelBackgroundVisibility)
void setLabelBorderVisible(bool newLabelBorderVisibility)
void setLabelFont(const QFont &newFont)
void setLabelTextColor(QColor newLabelTextColor)
void setLabelsVisible(bool newLabelsVisibility)
void setMultiHighlightColor(QColor newMultiHighlightColor)
void setPlotAreaBackgroundColor(QColor newBackgroundColor)
void setPlotAreaBackgroundVisible(bool newBackgroundVisibility)
void setSeriesColors(const QList<QColor> &newSeriesColors)
void setSeriesGradients(const QList<QLinearGradient> &newSeriesGradients)
void setSingleHighlightColor(QColor newSingleHighlightColor)
void setTheme(QGraphsTheme::Theme newTheme, QGraphsTheme::ForceTheme force = ForceTheme::No)
QColor singleHighlightColor() const
QGraphsTheme::Theme theme() const

Señales

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.

Los temas se pueden crear desde cero utilizando el valor de la enumeración « UserDefined ». Al crear un tema mediante el constructor predeterminado, se genera un nuevo tema definido por el usuario.

Personalización del tema

El tema predeterminado es ` QtGreen`, pero es posible personalizar cada propiedad.

La siguiente tabla enumera las propiedades controladas por un tema y los valores predeterminados para « UserDefined ».

Ejemplos de uso

Creación de un tema integrado sin modificaciones:

QGraphsTheme *theme = new QGraphsTheme();

Creación de un tema integrado y modificación de algunas propiedades:

QGraphsTheme *theme = new QGraphsTheme();
theme->setBackgroundVisible(false);
theme->setLabelBackgroundVisible(false);

Modificar un tema definido por el usuario. El tema se ha creado de la misma forma que en los fragmentos anteriores:

theme->setTheme(QGraphsTheme::Theme::UserDefined);
theme->setBackgroundColor(QColor(QRgb(0x99ca53)));
theme->setBackgroundVisible(true);
QList<QColor> colors = { QColor(QRgb(0x209fdf)) };
theme->setSeriesColors(colors);
theme->setColorStyle(QGraphsTheme::ColorStyle::Uniform);
theme->setLabelFont(QFont(QStringLiteral("Impact"), 35));
theme->setGridVisible(true);
auto gridline = theme->grid();
gridline.setMainColor(QColor(QRgb(0x99ca53)));
theme->setGrid(gridline);
theme->setLabelBackgroundColor(QColor(0xf6, 0xa6, 0x25, 0xa0));
theme->setLabelBackgroundVisible(true);
theme->setLabelBorderVisible(true);
theme->setLabelTextColor(QColor(QRgb(0x404044)));
theme->setMultiHighlightColor(QColor(QRgb(0x6d5fd5)));
theme->setSingleHighlightColor(QColor(QRgb(0xf6a625)));
theme->setBackgroundColor(QColor(QRgb(0xffffff)));

Modificar algunas propiedades después de haber aplicado el tema a un gráfico:

QQuickWidget quickWidget;
Q3DBarsWidgetItem bars;
bars.setWidget(&quickWidget);
bars.widget()->setMinimumSize(QSize(512, 512));
bars.activeTheme()->setTheme(QGraphsTheme::Theme::MixSeries);
QList<QColor> color = { QColor(Qt::red) };
bars.activeTheme()->setSeriesColors(color);
bars.activeTheme()->setSingleHighlightColor(Qt::yellow);

Documentación sobre tipos de miembros

enum class QGraphsTheme::ColorScheme

Representa la combinación de colores del gráfico.

ConstanteValorDescripción
QGraphsTheme::ColorScheme::Automatic0Los colores de fondo siguen la combinación de colores de la plataforma, si está disponible. Si no está disponible, se utiliza el aspecto «Claro».
QGraphsTheme::ColorScheme::Light1Los colores de fondo son más claros que el color del texto, es decir, el tema es claro.
QGraphsTheme::ColorScheme::Dark2Los colores de fondo son más oscuros que el color del texto, es decir, el tema es oscuro.

Véase también Qt::ColorScheme.

enum class QGraphsTheme::ColorStyle

Tipos de gradientes.

ConstanteValorDescripción
QGraphsTheme::ColorStyle::Uniform0Los objetos se representan en un único color. El color utilizado se especifica en las propiedades « seriesColors », « singleHighlightColor » y « multiHighlightColor ».
QGraphsTheme::ColorStyle::ObjectGradient1Los objetos se colorean utilizando un degradado completo para cada objeto, independientemente de su altura. El degradado utilizado se especifica en las propiedades ` seriesGradients`, ` singleHighlightGradient ` y ` multiHighlightGradient `.
QGraphsTheme::ColorStyle::RangeGradient2Los 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 « seriesGradients », « singleHighlightGradient » y « multiHighlightGradient ».

enum class QGraphsTheme::Theme

Temas integrados.

ConstanteValorDescripción
QGraphsTheme::Theme::QtGreen0Un tema claro con el verde como color de base.
QGraphsTheme::Theme::QtGreenNeon1Un tema claro con verde neón como color base.
QGraphsTheme::Theme::MixSeries2Un tema mixto con varios colores.
QGraphsTheme::Theme::OrangeSeries3Un tema con el naranja como color base.
QGraphsTheme::Theme::YellowSeries4Un tema con el amarillo como color base.
QGraphsTheme::Theme::BlueSeries5Un tema con el azul como color base.
QGraphsTheme::Theme::PurpleSeries6Un tema con el morado como color base.
QGraphsTheme::Theme::GreySeries7Un tema con el gris como color base.
QGraphsTheme::Theme::UserDefined8Un tema definido por el usuario. Para obtener más información, consulta Customizing Theme.

Documentación de propiedades

axisX : QGraphsLine

Las propiedades de estilo de la línea y la etiqueta del eje X del gráfico.

Funciones de acceso:

QGraphsLine axisX() const
void setAxisX(const QGraphsLine &newAxisX)

Señal de notificación:

void axisXChanged()

axisXLabelFont : QFont

Esta propiedad determina la fuente que se utilizará para las etiquetas del eje x.

Funciones de acceso:

QFont axisXLabelFont() const
void setAxisXLabelFont(const QFont &newAxisXLabelFont)

Señal de notificación:

void axisXLabelFontChanged()

axisY : QGraphsLine

Las propiedades de estilo de la línea y la etiqueta del eje Y del gráfico.

Funciones de acceso:

QGraphsLine axisY() const
void setAxisY(const QGraphsLine &newAxisY)

Señal de notificación:

void axisYChanged()

axisYLabelFont : QFont

Esta propiedad define la fuente que se utilizará para las etiquetas del eje Y.

Funciones de acceso:

QFont axisYLabelFont() const
void setAxisYLabelFont(const QFont &newAxisYLabelFont)

Señal de notificación:

void axisYLabelFontChanged()

axisZ : QGraphsLine

Las propiedades de estilo de la línea del eje Z y de las etiquetas del gráfico.

Funciones de acceso:

QGraphsLine axisZ() const
void setAxisZ(const QGraphsLine &newAxisZ)

Señal de notificación:

void axisZChanged()

axisZLabelFont : QFont

Esta propiedad establece la fuente que se utilizará para las etiquetas del eje z.

Funciones de acceso:

QFont axisZLabelFont() const
void setAxisZLabelFont(const QFont &newAxisZLabelFont)

Señal de notificación:

void axisZLabelFontChanged()

backgroundColor : QColor

Esta propiedad almacena el color de la vista en la que se dibuja el gráfico. El valor por defecto depende de colorScheme.

Funciones de acceso:

QColor backgroundColor() const
void setBackgroundColor(QColor newBackgroundColor)

Señal del notificador:

void backgroundColorChanged()

backgroundVisible : bool

Esta propiedad determina si el fondo está visible.

El fondo se dibuja utilizando el valor de « backgroundColor ». El valor por defecto es « true ».

Funciones de acceso:

bool isBackgroundVisible() const
void setBackgroundVisible(bool newBackgroundVisible)

Señal del notificador:

void backgroundVisibleChanged()

[read-only] baseColors : const QQmlListProperty<QQuickGraphsColor>

La lista de colores base que se utilizarán en la serie cuando se aplique el estilo de color « ColorStyle::Uniform ».

[read-only] baseGradients : const QQmlListProperty<QQuickGradient>

La lista de degradados básicos que se utilizarán en la serie cuando se aplique el estilo de color « ColorStyle::RangeGradient ».

borderColors : QList<QColor>

Esta propiedad contiene la lista de colores de borde 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 reinicia y vuelve a empezar por el primer color de la lista.

No tiene ningún efecto inmediato si « colorStyle » no es «Uniform».

Funciones de acceso:

QList<QColor> borderColors() const
void setBorderColors(const QList<QColor> &newBorderColors)

Señal de notificación:

void borderColorsChanged()

borderWidth : qreal

Esta propiedad establece el ancho de los bordes del gráfico, si los hay. El valor por defecto es « 1.0 ».

Funciones de acceso:

qreal borderWidth() const
void setBorderWidth(qreal newBorderWidth)

Señal de notificación:

void borderWidthChanged()

colorScheme : QGraphsTheme::ColorScheme

La combinación de colores del gráfico que se está utilizando.

Funciones de acceso:

QGraphsTheme::ColorScheme colorScheme() const
void setColorScheme(QGraphsTheme::ColorScheme newColorScheme)

Señal de notificación:

void colorSchemeChanged()

Véase también Qt::ColorScheme.

colorStyle : QGraphsTheme::ColorStyle

El estilo de los colores del gráfico. Uno de los valores de la enumeración « QGraphsTheme::ColorStyle ».

Este valor se puede anular estableciendo explícitamente Abstract3DSeries.colorStyle en la serie.

Nota: Esta propiedad no tiene efecto en Qt Graphs para gráficos 2D.

Funciones de acceso:

QGraphsTheme::ColorStyle colorStyle() const
void setColorStyle(QGraphsTheme::ColorStyle newColorStyle)

Señal de notificación:

void colorStyleChanged(QGraphsTheme::ColorStyle type)

Véase también QGraphsTheme::ColorStyle.

grid : QGraphsLine

Las propiedades de estilo de las líneas de la cuadrícula del gráfico.

Funciones de acceso:

QGraphsLine grid() const
void setGrid(const QGraphsLine &newGrid)

Señal del notificador:

void gridChanged()

gridVisible : 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. El valor predeterminado es « true ».

Funciones de acceso:

bool isGridVisible() const
void setGridVisible(bool newGridVisibility)

Señal de notificación:

void gridVisibleChanged()

labelBackgroundColor : QColor

Esta propiedad define el color de fondo de las etiquetas.

No tiene ningún efecto si « labelBackgroundVisible » tiene el valor « false ». El valor por defecto depende de « colorScheme ».

Funciones de acceso:

QColor labelBackgroundColor() const
void setLabelBackgroundColor(QColor newLabelBackgroundColor)

Señal de notificador:

void labelBackgroundColorChanged()

labelBackgroundVisible : 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. El valor por defecto es true.

Funciones de acceso:

bool isLabelBackgroundVisible() const
void setLabelBackgroundVisible(bool newLabelBackgroundVisibility)

Señal de notificación:

void labelBackgroundVisibleChanged()

labelBorderVisible : bool

Esta propiedad determina si se dibujan los bordes de las etiquetas que tienen fondo.

No tiene ningún efecto si « labelBackgroundVisible » es « false ». El valor por defecto es « true ».

Funciones de acceso:

bool isLabelBorderVisible() const
void setLabelBorderVisible(bool newLabelBorderVisibility)

Señal de notificación:

void labelBorderVisibleChanged()

labelFont : QFont

Esta propiedad especifica la fuente que se utilizará para las etiquetas.

Funciones de acceso:

QFont labelFont() const
void setLabelFont(const QFont &newFont)

Señal de notificación:

void labelFontChanged()

labelTextColor : QColor

Esta propiedad determina el color de la fuente utilizada para las etiquetas.

Si se ha especificado explícitamente « labelTextColor » en un eje, esto no tiene ningún efecto.

El valor por defecto depende de ` colorScheme`.

Funciones de acceso:

QColor labelTextColor() const
void setLabelTextColor(QColor newLabelTextColor)

Señal de notificación:

void labelTextColorChanged()

labelsVisible : bool

Esta propiedad determina si se dibujan las etiquetas.

Si se establece en « false », el resto de propiedades de las etiquetas no tendrán ningún efecto. El valor por defecto es « true ».

Funciones de acceso:

bool labelsVisible() const
void setLabelsVisible(bool newLabelsVisibility)

Señal de notificación:

void labelsVisibleChanged()

multiHighlightColor : QColor

Esta propiedad contiene el color de resaltado de los objetos seleccionados.

Se utiliza si en « selectionMode » (Configuración de la aplicación) se ha activado la opción « QtGraphs3D::SelectionFlag::Row » (Mostrar el color de resaltado) o « QtGraphs3D::SelectionFlag::Column » (Mostrar el color de resaltado de los objetos seleccionados). El valor por defecto depende de « colorScheme » (Configuración de la aplicación).

Funciones de acceso:

QColor multiHighlightColor() const
void setMultiHighlightColor(QColor newMultiHighlightColor)

Señal de notificador:

void multiHighlightColorChanged(QColor color)

multiHighlightGradient : QQuickGradient*

Esta propiedad contiene el degradado de resaltado de los objetos seleccionados.

Se utiliza si « selectionMode » tiene activada la bandera « QtGraphs3D::SelectionFlag::Row » o « QtGraphs3D::SelectionFlag::Column ». El valor por defecto depende de « colorScheme ».

Señal de notificación:

void multiHighlightGradientQMLChanged()

plotAreaBackgroundColor : QColor

Esta propiedad determina el color de fondo del área de trazado del gráfico. El valor por defecto depende de colorScheme.

Funciones de acceso:

QColor plotAreaBackgroundColor() const
void setPlotAreaBackgroundColor(QColor newBackgroundColor)

Señal de notificación:

void plotAreaBackgroundColorChanged()

plotAreaBackgroundVisible : bool

Esta propiedad determina si el fondo del área de trazado está visible.

El fondo se dibuja utilizando el valor de « plotAreaBackgroundColor ». El valor por defecto es « true ».

Funciones de acceso:

bool isPlotAreaBackgroundVisible() const
void setPlotAreaBackgroundVisible(bool newBackgroundVisibility)

Señal del notificador:

void plotAreaBackgroundVisibleChanged()

seriesColors : 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 reinicia y vuelve a empezar por el primer color de la lista.

No tiene ningún efecto inmediato si colorStyle no es Uniform.

Este valor se puede anular estableciendo explícitamente la opción « baseColor » en la serie.

Funciones de acceso:

QList<QColor> seriesColors() const
void setSeriesColors(const QList<QColor> &newSeriesColors)

Señal de notificador:

void seriesColorsChanged(const QList<QColor> &list)

singleHighlightColor : QColor

Esta propiedad almacena el color de resaltado de un objeto seleccionado.

Se utiliza si « selectionMode » tiene activada la opción « QtGraphs3D::SelectionFlag::Item ». El valor por defecto depende de « colorScheme ».

Funciones de acceso:

QColor singleHighlightColor() const
void setSingleHighlightColor(QColor newSingleHighlightColor)

Señal de notificador:

void singleHighlightColorChanged(QColor color)

singleHighlightGradient : QQuickGradient*

Esta propiedad contiene el degradado de resaltado de un objeto seleccionado.

Se utiliza si « selectionMode » tiene activada la opción « QtGraphs3D::SelectionFlag::Item ». El valor por defecto depende de « colorScheme ».

Señal de notificación:

void singleHighlightGradientQMLChanged()

theme : QGraphsTheme::Theme

El tipo del tema. Si no se establece ningún tipo, el tipo es « GraphsTheme.Theme.QtGreen ». Si se cambia el tipo del tema una vez creado el elemento, todas las demás propiedades del tema pasarán a ser las que especifica 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.

Funciones de acceso:

QGraphsTheme::Theme theme() const
void setTheme(QGraphsTheme::Theme newTheme, QGraphsTheme::ForceTheme force = ForceTheme::No)

Señal de notificación:

void themeChanged(QGraphsTheme::Theme theme)

[read-only] themeChildren : const QQmlListProperty<QObject>

La lista de objetos secundarios del tema. Se trata de una propiedad predeterminada que permite especificar objetos secundarios dentro del elemento «Theme» en QML sin necesidad de utilizar explícitamente el nombre de la propiedad «children».

Documentación de las funciones de miembro

QList<QLinearGradient> QGraphsTheme::seriesGradients() const

Devuelve la lista de gradientes de series utilizados por el tema.

Véase también setSeriesGradients().

void QGraphsTheme::setSeriesGradients(const QList<QLinearGradient> &newSeriesGradients)

Establece « newSeriesGradients » como los degradados de la serie para el tema.

Véase también seriesGradients().

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