Theme3D QML Type

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

• Lista de todos los miembros, incluidos los heredados

Propiedades

• ambientLightStrength : real
• backgroundColor : color
• backgroundEnabled : bool
• baseColors : list<ThemeColor>
• baseGradients : list<ColorGradient>
• colorStyle : Theme3D.ColorStyle
• font : font
• gridEnabled : bool
• gridLineColor : color
• highlightLightStrength : real
• labelBackgroundColor : color
• labelBackgroundEnabled : bool
• labelBorderEnabled : bool
• labelTextColor : color
• lightColor : color
• lightStrength : real
• multiHighlightColor : color
• multiHighlightGradient : ColorGradient
• singleHighlightColor : color
• singleHighlightGradient : ColorGradient
• type : Theme3D.Theme
• windowColor : color

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.

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

Los temas pueden crearse desde cero utilizando el valor enum Theme3D.ThemeUserDefined.

Tema por defecto

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

Ejemplos de uso

Usando un tema incorporado sin ninguna modificación:

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

Usando un tema incorporado y modificando algunas propiedades:

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

Utilizar 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 los enums Theme3D, consulte 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 que se muestran los colores en todo el gráfico, independientemente de la posición de la luz. El valor debe estar entre 0.0 y 1.0.

backgroundColor : color

El color del fondo del gráfico.

backgroundEnabled : bool

Define si se dibuja el fondo utilizando el valor de backgroundColor.

baseColors : list<ThemeColor>

La lista de colores base 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 Theme3D.ColorStyleUniform.

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

baseGradients : list<ColorGradient>

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

Este valor puede anularse estableciendo Abstract3DSeries.baseGradient explícitamente en la serie.

colorStyle : Theme3D.ColorStyle

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

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

Véase también Q3DTheme::ColorStyle.

font : font

Establece la fuente que se utilizará para las etiquetas.

gridEnabled : bool

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

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 del fondo de las etiquetas. No tiene efecto si labelBackgroundEnabled es false.

labelBackgroundEnabled : 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.

labelBorderEnabled : bool

Define si se dibujan los bordes de las etiquetas que tienen fondo. No tiene efecto si labelBackgroundEnabled es 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 entre 0.0 y 10.0.

Este valor afecta a la luz especificada en Scene3D.

multiHighlightColor : color

Color de realce de los objetos seleccionados. Se utiliza si selectionMode tiene definida la opción AbstractGraph3D.SelectionRow o AbstractGraph3D.SelectionColumn.

multiHighlightGradient : ColorGradient

El gradiente de resaltado de los objetos seleccionados. Se utiliza si selectionMode tiene definida la opción AbstractGraph3D.SelectionRow o AbstractGraph3D.SelectionColumn.

singleHighlightColor : color

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

singleHighlightGradient : ColorGradient

El gradiente de resaltado de un objeto seleccionado. Se utiliza si selectionMode tiene activada la opción AbstractGraph3D.SelectionItem.

type : Theme3D.Theme

Tipo del tema. Si no se define ningún tipo, el tipo es Theme3D.ThemeUserDefined. Cambiar el tipo de tema después de que el elemento haya sido construido cambiará todas las demás propiedades del tema 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.

windowColor : color

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