En esta página

GraphsTheme QML Type

Un estilo visual para los gráficos. Más...

Import Statement: import QtGraphs
In C++: QGraphsTheme

Propiedades

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.

Los temas se pueden crear desde cero utilizando el valor de la enumeración « GraphsTheme.Theme.UserDefined ».

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 « QGraphsTheme.Theme.UserDefined ».

Ejemplos de uso

Uso de un tema integrado sin modificaciones:

Scatter3D {
    theme: GraphsTheme { theme: GraphsTheme.Theme.YellowSeries }
    ...

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

Bars3D {
    theme: GraphsTheme {
        theme: GraphsTheme.Theme.QtGreenNeon
        labelBorderVisible: true
        labelFont.pointSize: 35
        labelBackgroundVisible: false
    }
    ...

Uso de un tema definido por el usuario:

Surface3D {
    theme: GraphsTheme {
        theme: GraphsTheme.Theme.UserDefined
        backgroundColor: "red"
        backgroundVisible: true
        seriesColors: ["blue"]
        colorStyle: GraphsTheme.ColorStyle.Uniform
        labelFont.family: "Lucida Handwriting"
        labelFont.pointSize: 35
        gridVisible: false
        grid.mainColor: "red"
        grid.subColor: "blue"
        labelBackgroundColor: "black"
        labelBackgroundVisible: true
        labelBorderVisible: false
        labelTextColor: "white"
        multiHighlightColor: "green"
        singleHighlightColor: "darkRed"
    }
    ...

Para las enumeraciones de GraphsTheme, consulta GraphsTheme::colorStyle y GraphsTheme::theme.

Documentación de propiedades

GraphsLine.labelTextColor : color

El color del texto utilizado para las etiquetas. El valor por defecto depende de colorScheme.

GraphsLine.mainColor : color

El color de las líneas principales. El valor por defecto depende de colorScheme.

GraphsLine.mainWidth : real

El ancho de las líneas principales. El valor por defecto es « 2.0 ».

Si se configura para las líneas de la cuadrícula, solo surte efecto si GraphsItem3D::gridLineType está Graphs3D.GridLineType.Shader

Véase también Graphs3D.GridLineType.

GraphsLine.subColor : color

El color de las líneas secundarias. El valor por defecto depende de colorScheme.

GraphsLine.subWidth : real

El ancho de las sublíneas. El valor por defecto es « 1.0 ».

Si se configura para las líneas de la cuadrícula, solo surte efecto si GraphsItem3D::gridLineType está Graphs3D.GridLineType.Shader

Véase también Graphs3D.GridLineType.

axisX : GraphsLine

Almacena el valor « GraphsLine » del eje X.

Véase también GraphsLine.mainColor, GraphsLine.subColor, GraphsLine.mainWidth, GraphsLine.subWidth y GraphsLine.labelTextColor.

axisXLabelFont : font

Establece la fuente que se utilizará para las etiquetas en axisX.

axisY : GraphsLine

Contiene el valor « GraphsLine » del eje Y.

Véase también GraphsLine.mainColor, GraphsLine.subColor, GraphsLine.mainWidth, GraphsLine.subWidth y GraphsLine.labelTextColor.

axisYLabelFont : font

Establece la fuente que se utilizará para las etiquetas en axisY.

axisZ : GraphsLine

Almacena el valor de « GraphsLine » del eje Z.

Véase también « GraphsLine.mainColor », « GraphsLine.subColor », « GraphsLine.mainWidth », « GraphsLine.subWidth » y « GraphsLine.labelTextColor ».

axisZLabelFont : font

Establece la fuente que se utilizará para las etiquetas en axisZ.

backgroundColor : color

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

backgroundVisible : bool

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

baseColors : list<Color> [read-only]

Lista de colores base de tipo Color 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 ` GraphsTheme.ColorStyle.Uniform`.

Ejemplo de uso:

baseColors: [ Color { color: "red" } ]

Esto se puede anular estableciendo explícitamente ` Abstract3DSeries.baseColor ` en la serie.

baseGradients : list<Gradient> [read-only]

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 « GraphsTheme.ColorStyle.Uniform ».

Ejemplo de uso:

baseGradients: [ Gradient {
    GradientStop { position: 1.0; color: "#DBEB00" }
    GradientStop { position: 0.0; color: "#373F26" }
} ]

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

borderColors : list<color>

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 efecto inmediato si « colorStyle » no es «Uniform».

colorScheme : QGraphsTheme::ColorScheme

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

Véase también QGraphsTheme::ColorScheme.

colorStyle : GraphsTheme.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 en 2D.

Véase también QGraphsTheme::ColorStyle.

grid : GraphsLine

Contiene el documento « GraphsLine » del tema.

Véase también GraphsLine.mainColor, GraphsLine.subColor, GraphsLine.mainWidth, GraphsLine.subWidth y GraphsLine.labelTextColor.

gridVisible : bool

Define si se dibujan las líneas de la cuadrícula. Este valor afecta a todas las líneas de la cuadrícula. El valor por defecto es « true ».

labelBackgroundColor : color

El color de fondo de las etiquetas. No tiene ningún efecto si « labelBackgroundVisible » es « false ». El valor por defecto depende de « colorScheme ».

labelBackgroundVisible : bool

Define si la etiqueta se dibuja con un fondo que utiliza un « 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 queda centrado 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.

labelBorderVisible : bool

Define si se dibujan los bordes de las etiquetas que tienen fondo. No tiene ningún efecto si « labelBackgroundVisible » está establecido en « false ». El valor por defecto es « true ».

labelFont : font

Establece la fuente que se utilizará para las etiquetas.

labelTextColor : color

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

labelsVisible : bool

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

multiHighlightColor : color

El color de resaltado de los objetos seleccionados. Se utiliza si en « selectionMode » se ha activado la opción « Graphs3D.SelectionFlag.Row » o « Graphs3D.SelectionFlag.Column ». El valor por defecto depende de « colorScheme ».

Véase también Graphs3D.SelectionFlag.

multiHighlightGradient : Gradient

El degradado de resaltado para los objetos seleccionados. Se utiliza si en « selectionMode » se ha activado la opción « Graphs3D.SelectionFlag.Row » o « Graphs3D.SelectionFlag.Column ». El valor por defecto depende de « colorScheme ».

Véase también Graphs3D.SelectionFlag.

plotAreaBackgroundColor : color

El color del fondo del área de trazo del gráfico. El valor por defecto depende de colorScheme.

plotAreaBackgroundVisible : bool

Define si el fondo del área de representación se dibuja utilizando el valor de « plotAreaBackgroundColor ». El valor por defecto es « true ».

seriesColors : list<color>

La lista de colores 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 está ` GraphsTheme.ColorStyle.Uniform`.

Ejemplo de uso:

seriesColors: [ "red" ]

Esto se puede anular estableciendo explícitamente Abstract3DSeries.baseColor en la serie.

singleHighlightColor : color

El color de resaltado de un objeto seleccionado. Se utiliza si en « selectionMode » se ha activado el indicador « Graphs3D.SelectionFlag.Item ». El valor por defecto depende de « colorScheme ».

Véase también Graphs3D.SelectionFlag.

singleHighlightGradient : Gradient

El degradado de resaltado para un objeto seleccionado. Se utiliza si en « selectionMode » se ha activado la opción « Graphs3D.SelectionFlag.Item ». El valor por defecto depende de « colorScheme ».

Véase también Graphs3D.SelectionFlag.

theme : GraphsTheme.Theme

El tipo del tema. Si no se especifica ningún tipo, el tipo por defecto es « GraphsTheme.Theme.QtGreen ». 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, todas las series asociadas se restablecerán para que utilicen el nuevo 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.