Theme3D QML 类型

图形的视觉样式。更多...

导入声明	import QtDataVisualization 1.7
自	QtDataVisualization 1.0
实例化	Q3DTheme

所有成员列表，包括继承成员

属性

环境光强度 : real
背景颜色 : color
背景启用 : bool
基础颜色 : list<ThemeColor>
基础渐变 : list<ColorGradient>
颜色样式 : Theme3D.ColorStyle
字体 : font
网格启用 : bool
网格线条颜色 : color
高亮光强度 : real
标签背景颜色 : color
标签背景启用 : bool
标签边框启用 : bool
标签文本颜色 : color
光线颜色 : color
光线强度 : real
多重高亮颜色 : color
多重高亮渐变 : ColorGradient
单重高亮颜色 : color
单重高亮渐变 : ColorGradient
类型 : Theme3D.Theme
窗口颜色 : color

详细描述

此类型用于指定影响整个图形的视觉属性。有几个内置主题可以直接使用或自由修改。

以下属性可以使用 Abstract3DSeries 属性覆盖，以在系列中显式设置它们： baseColors、baseGradients 和 colorStyle。

通过使用Theme3D.ThemeUserDefined枚举值，可以从头创建主题。

默认主题

以下表格列出了主题控制的属性以及Theme3D.ThemeUserDefined的默认值。

属性	默认值
ambientLightStrength	0.25
backgroundColor	"black". 更多信息，请参见颜色。
backgroundEnabled	`true`
baseColors	"black"
baseGradients	QLinearGradient.基本全黑色。
colorStyle	ColorStyleUniform
font	font
gridEnabled	`true`
gridLineColor	"white"
highlightLightStrength	7.5
labelBackgroundColor	"gray"
labelBackgroundEnabled	`true`
labelBorderEnabled	`true`
labelTextColor	"white"
lightColor	"white"
lightStrength	5.0
multiHighlightColor	"blue"
multiHighlightGradient	QLinearGradient.基本全黑色。
singleHighlightColor	"red"
singleHighlightGradient	QLinearGradient.基本全黑色。
windowColor	"black"

使用示例

使用未经修改的内置主题

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

使用内置主题并修改一些属性

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

使用用户定义的主题

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"
    }
    ...
}

有关Theme3D枚举，请参见Q3DTheme::ColorStyle和Q3DTheme::Theme。

属性文档

ambientLightStrength : 实数

整个图的周围光强度。此值决定了颜色在图中无论光源位置如何都显示得如何均匀和明亮。值必须在0.0和1.0之间。

backgroundColor : 颜色

图的背景颜色。

backgroundEnabled : 布尔型

定义是否使用backgroundColor的值来绘制背景。

baseColors : 列表<ThemeColor>

用于图中所有对象的基颜色列表，按序列顺序。如果有比颜色多的序列，颜色列表将循环，并从列表中的第一个颜色开始。如果colorStyle不是Theme3D.ColorStyleUniform，则 immediate effect.

可以在序列中明确设置Abstract3DSeries.baseColor来覆盖此值。

baseGradients : 列表<ColorGradient>

用于图中所有对象的基渐变列表，按序列顺序。如果有比渐变多的序列，则渐变列表将循环，并从列表中的第一个渐变开始。

如果colorStyle不是Theme3D.ColorStyleUniform，则无 immediate effect.

可以在序列中明确设置Abstract3DSeries.baseGradient来覆盖此值。

colorStyle : Theme3D.ColorStyle

图的颜色的样式。是Q3DTheme::ColorStyle枚举值之一。

可以在序列中明确设置Abstract3DSeries.colorStyle来覆盖此值。

另请参阅Q3DTheme::ColorStyle.

font : font

设置用于标签的字体。

gridEnabled : bool

定义是否绘制网格线。此值会影响所有网格线。

gridLineColor : color

网格线的颜色。

注意：不支持透明度，将导致未定义的行为。

highlightLightStrength : real

选中对象的镜面反射光强度。值必须在 0.0 和 10.0 之间。

labelBackgroundColor : color

标签背景的颜色。如果 labelBackgroundEnabled 为 false，则无效果。

labelBackgroundEnabled : bool

定义是否使用 labelBackgroundColor（包括 alpha）的背景绘制标签，或者绘制纯透明背景的标签。具有背景的标签会根据最长标签在每个轴上绘制相同大小，并在其中居中文本。无背景的标签将原样绘制，并根据其在图表中的位置左对齐或右对齐。

labelBorderEnabled : bool

定义是否为具有背景的标签绘制标签边框。如果 labelBackgroundEnabled 为 false，则无效果。

labelTextColor : color

用于标签的字体颜色。

lightColor : color

在 Scene3D 中定义的环境光和镜面反射光颜色。

lightStrength : real

整个图表的镜面反射光强度。值必须在 0.0 和 10.0 之间。

此值会影响 Scene3D 中指定的光线。

multiHighlightColor : color

选中对象的突出显示颜色。如果 selectionMode 设置了 AbstractGraph3D.SelectionRow 或 AbstractGraph3D.SelectionColumn 标志，则使用此颜色。

注意：不支持透明度，将导致未定义的行为。

multiHighlightGradient : ColorGradient

选中对象的突出显示渐变。如果 selectionMode 设置了 AbstractGraph3D.SelectionRow 或 AbstractGraph3D.SelectionColumn 标志，则使用此渐变。

注意：不支持透明度，将导致未定义的行为。

singleHighlightColor : color

选中对象的突出显示颜色。如果 selectionMode 设置了 AbstractGraph3D.SelectionItem 标志，则使用此颜色。

注意：不支持透明度，将导致未定义的行为。

singleHighlightGradient : ColorGradient

选中对象的突出显示渐变。如果 selectionMode 设置了 AbstractGraph3D.SelectionItem 标志，则使用此渐变。

注意：不支持透明度，将导致未定义的行为。

type : Theme3D.Theme

主题的类型。如果没有设置类型，类型为 Theme3D.ThemeUserDefined。在构造项之后更改主题类型将会将主题的所有其他属性更改为预定义主题指定的属性。更改图表当前主题的类型也将重置所有附加系列以使用新的主题。

windowColor : 颜色

图表绘制到应用程序窗口中的颜色。