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 |
- Lista de todos los miembros, incluidos los heredados
- QGraphsTheme forma parte de las clases comunes de C++ deQt Graphs .
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
| void | axisXChanged() |
| void | axisXLabelFontChanged() |
| void | axisYChanged() |
| void | axisYLabelFontChanged() |
| void | axisZChanged() |
| void | axisZLabelFontChanged() |
| void | backgroundColorChanged() |
| void | backgroundVisibleChanged() |
| void | borderColorsChanged() |
| void | borderWidthChanged() |
| void | colorSchemeChanged() |
| void | colorStyleChanged(QGraphsTheme::ColorStyle type) |
| void | gridChanged() |
| void | gridVisibleChanged() |
| void | labelBackgroundColorChanged() |
| void | labelBackgroundVisibleChanged() |
| void | labelBorderVisibleChanged() |
| void | labelFontChanged() |
| void | labelTextColorChanged() |
| void | labelsVisibleChanged() |
| void | multiHighlightColorChanged(QColor color) |
| void | multiHighlightGradientQMLChanged() |
| void | plotAreaBackgroundColorChanged() |
| void | plotAreaBackgroundVisibleChanged() |
| void | seriesColorsChanged(const QList<QColor> &list) |
| void | singleHighlightColorChanged(QColor color) |
| void | singleHighlightGradientQMLChanged() |
| void | themeChanged(QGraphsTheme::Theme theme) |
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 ».
| Propiedad | Valor por defecto |
|---|---|
| backgroundVisible | true |
| seriesColors | Qt::black |
| seriesGradients | QLinearGradient. Prácticamente totalmente negro. |
| colorStyle | Uniforme |
| labelFont | QFont |
| gridVisible | true |
| labelBackgroundVisible | true |
| labelBorderVisible | true |
| labelsVisible | true |
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.
| Constante | Valor | Descripción |
|---|---|---|
QGraphsTheme::ColorScheme::Automatic | 0 | Los 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::Light | 1 | Los colores de fondo son más claros que el color del texto, es decir, el tema es claro. |
QGraphsTheme::ColorScheme::Dark | 2 | Los 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.
| Constante | Valor | Descripción |
|---|---|---|
QGraphsTheme::ColorStyle::Uniform | 0 | Los objetos se representan en un único color. El color utilizado se especifica en las propiedades « seriesColors », « singleHighlightColor » y « multiHighlightColor ». |
QGraphsTheme::ColorStyle::ObjectGradient | 1 | Los 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::RangeGradient | 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 « seriesGradients », « singleHighlightGradient » y « multiHighlightGradient ». |
enum class QGraphsTheme::Theme
Temas integrados.
| Constante | Valor | Descripción |
|---|---|---|
QGraphsTheme::Theme::QtGreen | 0 | Un tema claro con el verde como color de base. |
QGraphsTheme::Theme::QtGreenNeon | 1 | Un tema claro con verde neón como color base. |
QGraphsTheme::Theme::MixSeries | 2 | Un tema mixto con varios colores. |
QGraphsTheme::Theme::OrangeSeries | 3 | Un tema con el naranja como color base. |
QGraphsTheme::Theme::YellowSeries | 4 | Un tema con el amarillo como color base. |
QGraphsTheme::Theme::BlueSeries | 5 | Un tema con el azul como color base. |
QGraphsTheme::Theme::PurpleSeries | 6 | Un tema con el morado como color base. |
QGraphsTheme::Theme::GreySeries | 7 | Un tema con el gris como color base. |
QGraphsTheme::Theme::UserDefined | 8 | Un 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.