En esta página

Theme3D QML Type

Un estilo visual para gráficos. Más información...

Import Statement: import QtDataVisualization 1.12
Since: QtDataVisualization 1.0
In C++: Q3DTheme
Status: Deprecated

Este tipo está obsoleto. Recomendamos encarecidamente no utilizarlo en código nuevo.

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.

Las siguientes propiedades pueden sobrescribirse utilizando las propiedades ` Abstract3DSeries ` para configurarlas explícitamente en la serie: ` baseColors`, ` baseGradients` y ` colorStyle`.

Se pueden crear temas desde cero utilizando el valor de la enumeración « Theme3D.ThemeUserDefined ».

Tema predeterminado

La siguiente tabla enumera las propiedades controladas por los temas y los valores predeterminados para « Theme3D.ThemeUserDefined ».

PropiedadValor predeterminado
ambientLightStrength0,25
backgroundColor«black». Para obtener más información, consulta color.
backgroundEnabledtrue
baseColors«black»
baseGradientsQLinearGradient. Prácticamente totalmente negro.
colorStyleColorStyleUniform
fontfont
gridEnabledtrue
gridLineColor«blanco»
highlightLightStrength7,5
labelBackgroundColor«gris»
labelBackgroundEnabledtrue
labelBorderEnabledtrue
labelTextColor«blanco»
lightColor«blanco»
lightStrength5,0
multiHighlightColor«azul»
multiHighlightGradientQLinearGradient. Prácticamente todo negro.
singleHighlightColor«rojo»
singleHighlightGradientQLinearGradient. Prácticamente todo negro.
windowColor«negro»

Ejemplos de uso

Uso de un tema integrado sin modificaciones:

Scatter3D {
    ...
    theme: Theme3D { type: Theme3D.ThemeRetro }
    ...
}

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

Bars3D {
    ...
    theme: Theme3D {
        type: Theme3D.ThemeRetro
        labelBorderEnabled: true
        font.pointSize: 35
        labelBackgroundEnabled: false
    }
    ...
}

Uso de un tema definido por el usuario:

Surface3D {
    ...
    theme: Theme3D {
        ambientLightStrength: 0.5
        backgroundColor: "red"
        backgroundEnabled: true
        baseColor: "blue"
        colorStyle: Theme3D.ColorStyleUniform
        font.family: "Lucida Handwriting"
        font.pointSize: 35
        gridEnabled: false
        gridLineColor: "black"
        highlightLightStrength: 0.5
        labelBackgroundColor: "black"
        labelBackgroundEnabled: true
        labelBorderEnabled: false
        labelTextColor: "white"
        lightColor: "yellow"
        lightStrength: 0.4
        multiHighlightColor: "green"
        singleHighlightColor: "darkRed"
        windowColor: "white"
    }
    ...
}

Para las enumeraciones de Theme3D, consulta Q3DTheme::ColorStyle y Q3DTheme::Theme.

Documentación de propiedades

ambientLightStrength : real

La intensidad de la luz ambiental para todo el gráfico. Este valor determina la uniformidad y el brillo con los 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.0 y 1.0.

backgroundColor : color

El color del fondo del gráfico.

backgroundEnabled : bool

Establece si el fondo se dibuja utilizando el valor de « backgroundColor ».

baseColors : list<ThemeColor>

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 repite y vuelve a empezar por el primer color de la lista. No tiene efecto inmediato si colorStyle no es Theme3D.ColorStyleUniform.

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

baseGradients : list<ColorGradient>

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

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

colorStyle : Theme3D.ColorStyle

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

Este valor se puede anular estableciendo Abstract3DSeries.colorStyle de forma explícita en la serie.

Véase también Q3DTheme::ColorStyle.

font : font

Establece la fuente que se utilizará para las etiquetas.

gridEnabled : bool

Determina si se dibujan las líneas de la cuadrícula. Este valor afecta a todas las líneas de la cuadrícula.

gridLineColor : color

El color de las líneas de la cuadrícula.

Nota: La transparencia no es compatible y provocará un comportamiento indefinido.

highlightLightStrength : real

La intensidad de la luz especular para los objetos seleccionados. El valor debe estar comprendido entre 0.0 y 10.0.

labelBackgroundColor : color

El color de fondo de las etiquetas. No tiene ningún efecto si la opción « labelBackgroundEnabled » está configurada como « false ».

labelBackgroundEnabled : bool

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

labelBorderEnabled : bool

Determina si se dibujan los bordes de las etiquetas que tienen fondo. No tiene ningún efecto si la opción « labelBackgroundEnabled » está establecida en « false ».

labelTextColor : color

El color de la fuente utilizada para las etiquetas.

lightColor : color

El color de la luz ambiental y especular definido en Scene3D.

lightStrength : real

La intensidad de la luz especular para todo el gráfico. El valor debe estar comprendido entre 0.0 y 10.0.

Este valor afecta a la luz especificada en Scene3D.

multiHighlightColor : color

El color de resaltado para los objetos seleccionados. Se utiliza si en « selectionMode » se ha activado la opción « AbstractGraph3D.SelectionRow » o « AbstractGraph3D.SelectionColumn ».

Nota: No se admitela transparencia y su uso dará lugar a un comportamiento indefinido.

multiHighlightGradient : ColorGradient

selectionMode El degradado de resaltado para los objetos seleccionados. Se utiliza si se ha activado la opción « AbstractGraph3D.SelectionRow » con el indicador « » o « AbstractGraph3D.SelectionColumn ».

Nota: No se admitela transparencia y dará lugar a un comportamiento indefinido.

singleHighlightColor : color

El color de resaltado de un objeto seleccionado. Se utiliza si ` selectionMode ` tiene activada la opción « AbstractGraph3D.SelectionItem ».

Nota: No se admitela transparencia y dará lugar a un comportamiento indefinido.

singleHighlightGradient : ColorGradient

El degradado de resaltado de un objeto seleccionado. Se utiliza si en « selectionMode » se ha activado la opción « AbstractGraph3D.SelectionItem ».

Nota: No se admitela transparencia y provocará un comportamiento indefinido.

type : Theme3D.Theme

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

windowColor : color

El color de la ventana de la aplicación en la que se dibuja el gráfico.

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