En esta página

GraphsTheme QML Type

Un estilo visual para 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 incorporados que pueden utilizarse tal cual o modificarse libremente.

Los temas pueden crearse desde cero utilizando el valor enum GraphsTheme.Theme.UserDefined.

Personalización del tema

El tema por defecto es QtGreen, pero es posible personalizar cada propiedad.

La siguiente tabla lista las propiedades controladas por un tema y los valores por defecto para QGraphsTheme.Theme.UserDefined.

Ejemplos de uso

Utilizando un tema incorporado sin ninguna modificación:

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

Utilizando un tema incorporado y modificando algunas propiedades:

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

Utilizar 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 los enums de GraphsTheme, véase 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

La anchura de las líneas principales. El valor por defecto es 2.0.

Si se establece para las líneas de la cuadrícula, sólo tiene efecto si GraphsItem3D::gridLineType es Graphs3D.GridLineType.Shader

Véase también Graphs3D.GridLineType.

GraphsLine.subColor : color

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

GraphsLine.subWidth : real

La anchura de las sublíneas. El valor por defecto es 1.0.

Si se establece para líneas de cuadrícula, sólo tiene efecto si GraphsItem3D::gridLineType es Graphs3D.GridLineType.Shader

Véase también Graphs3D.GridLineType.

axisX : GraphsLine

Contiene la dirección GraphsLine del eje X.

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

axisXLabelFont : font

Establece el tipo de letra que se utilizará para las etiquetas en axisX.

axisY : GraphsLine

Contiene la dirección GraphsLine del eje Y.

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

axisYLabelFont : font

Establece el tipo de letra que se utilizará para las etiquetas en axisY.

axisZ : GraphsLine

Contiene el GraphsLine del eje Z.

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

axisZLabelFont : font

Establece el tipo de letra 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]

La lista de colores base de tipo Color a utilizar para todos los objetos del gráfico, serie por serie. Si hay más series que colores, la lista de colores se envuelve y comienza de nuevo con 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 puede anularse estableciendo Abstract3DSeries.baseColor explícitamente en la serie.

baseGradients : list<Gradient> [read-only]

La lista de degradados base que se utilizará para todos los objetos del gráfico, serie por serie. Si hay más series que gradientes, la lista de gradientes se envuelve y comienza de nuevo con el primer gradiente de la lista.

No tiene 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 puede anularse estableciendo Abstract3DSeries.baseGradient explícitamente en la serie.

borderColors : list<color>

La lista de colores de borde que se utilizará para todos los objetos del gráfico, serie por serie.

Si hay más series que colores, la lista de colores se envuelve y comienza de nuevo con el primer color de la lista.

No tiene efecto inmediato si colorStyle no es Uniforme.

colorScheme : QGraphsTheme::ColorScheme

La combinación de colores del gráfico en uso.

Véase también QGraphsTheme::ColorScheme.

colorStyle : GraphsTheme.ColorStyle

El estilo de los colores del gráfico. Uno de los valores del enum QGraphsTheme::ColorStyle.

Este valor puede anularse configurando Abstract3DSeries.colorStyle explícitamente en la serie.

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

Véase también QGraphsTheme::ColorStyle.

grid : GraphsLine

Contiene el 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 del fondo de las etiquetas. No tiene 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 labelBackgroundColor (incluyendo alfa), o con un fondo totalmente transparente. Las etiquetas con fondo se dibujan con tamaños iguales por eje en función de 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 en función de 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 efecto si labelBackgroundVisible es 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 un eje ha especificado labelTextColor explícitamente, esto no tiene ningún efecto.

El valor por defecto depende de colorScheme.

labelsVisible : bool

Define si las etiquetas se dibujan o no. Si es false, el resto de propiedades de las etiquetas no tienen ningún efecto. El valor por defecto es true.

multiHighlightColor : color

Color de realce de los objetos seleccionados. Se utiliza si selectionMode tiene activada la bandera Graphs3D.SelectionFlag.Row o Graphs3D.SelectionFlag.Column. El valor por defecto depende de colorScheme.

Véase también Graphs3D.SelectionFlag.

multiHighlightGradient : Gradient

El gradiente de resaltado de los objetos seleccionados. Se utiliza si selectionMode tiene activada la bandera 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 del gráfico. El valor por defecto depende de colorScheme.

plotAreaBackgroundVisible : bool

Define si el fondo del área de trazado se dibuja utilizando el valor de plotAreaBackgroundColor. El valor por defecto es true.

seriesColors : list<color>

La lista de colores a utilizar para todos los objetos del gráfico, serie por serie. Si hay más series que colores, la lista de colores se envuelve y comienza de nuevo con el primer color de la lista. No tiene efecto inmediato si colorStyle no es GraphsTheme.ColorStyle.Uniform.

Ejemplo de uso:

seriesColors: [ "red" ]

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

singleHighlightColor : color

El color de resaltado de un objeto seleccionado. Se utiliza si selectionMode tiene activada la bandera Graphs3D.SelectionFlag.Item. El valor por defecto depende de colorScheme.

Véase también Graphs3D.SelectionFlag.

singleHighlightGradient : Gradient

El gradiente de resaltado de un objeto seleccionado. Se utiliza si selectionMode tiene activada la bandera Graphs3D.SelectionFlag.Item. El valor por defecto depende de colorScheme.

Véase también Graphs3D.SelectionFlag.

theme : GraphsTheme.Theme

Tipo del tema. Si no se define ningún tipo, el tipo es GraphsTheme.Theme.QtGreen. Si se cambia el tipo de tema una vez construido el elemento, todas las demás propiedades del tema cambiarán a lo que especifique el tema predefinido. Al cambiar el tipo de tema del tema activo del gráfico también se restablecerán todas las series adjuntas 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.