Theme3D QML 类型

图形的视觉风格。更多...

导入语句	import QtGraphs
实例化	Q3DTheme
状态	技术预览

所有成员列表，包括继承成员
Theme3D 是 Qt 图形 QML 类型 3D 的一部分。

属性

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

详细描述

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

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

可以使用 Theme3D.Theme.UserDefined 枚举值从头创建主题。

默认主题

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

属性	默认值
ambientLightStrength	0.25
backgroundColor	"黑色"。有关更多信息，请参阅颜色。
backgroundEnabled	`true`
baseColors	"黑色"
baseGradients	QLinearGradient。主要是全黑色。
colorStyle	Uniform
font	font
gridEnabled	`true`
gridLineColor	"白色"
labelBackgroundColor	"灰色"
labelBackgroundEnabled	`true`
labelBorderEnabled	`true`
labelTextColor	"白色"
labelsEnabled	`true`
lightColor	"白色"
lightStrength	5.0
multiHighlightColor	"蓝色"
multiHighlightGradient	QLinearGradient。主要是全黑色。
singleHighlightColor	"红色"
singleHighlightGradient	QLinearGradient。主要是全黑色。
windowColor	"黑色"

使用示例

使用未修改的内置主题

Scatter3D {
    ...
    theme: Theme3D { type: Theme3D.Theme.Retro }
    ...
}

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

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

使用用户定义的主题

Surface3D {
    ...
    theme: Theme3D {
        ambientLightStrength: 0.5
        backgroundColor: "red"
        backgroundEnabled: true
        baseColors: ["blue"]
        colorStyle: Theme3D.ColorStyle.Uniform
        font.family: "Lucida Handwriting"
        font.pointSize: 35
        gridEnabled: false
        gridLineColor: "black"
        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 : 列表<颜色> [只读]

用于图表中所有对象的基础颜色列表，系列一个接一个。如果系列多于颜色，颜色列表将循环，从列表中的第一个颜色开始。如果colorStyle不是Theme3D.ColorStyle.Uniform，则没有即时效果。

可以在系列中显式设置Abstract3DSeries.baseColor以覆盖此值。

baseGradients : 列表<渐变> [只读]

用于图表中所有对象的基础渐变列表，系列一个接一个。如果系列多于渐变，渐变列表将循环，从列表中的第一个渐变开始。

如果colorStyle是Theme3D.ColorStyle.Uniform，则没有即时效果。

可以在系列中显式设置Abstract3DSeries.baseGradient以覆盖此值。

colorStyle : Theme3D.ColorStyle

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

可以在系列中显式设置Abstract3DSeries.colorStyle以覆盖此值。

另请参阅Q3DTheme::ColorStyle。

font : 字体

设置用于标签的字体。

gridEnabled : 布尔值

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

gridLineColor : 颜色

网格线的颜色。

labelBackgroundColor : 颜色

标签背景的颜色。如果 labelBackgroundEnabled 设置为 false，则不起作用。

labelBackgroundEnabled : 布尔值

定义标签是否用颜色为 labelBackgroundColor（包括 alpha 值）的背景绘制，或使用完全透明的背景。带有背景的标签将根据最长的标签在各个轴向上绘制为相同大小，文本在其中居中。不带背景的标签将按照其位于图中的位置进行绘制和对齐。

labelBorderEnabled : 布尔值

定义标签是否绘制带有背景。如果 labelBackgroundEnabled 设置为 false，则不起作用。

labelTextColor : 颜色

用于标签的字体颜色。

labelsEnabled : 布尔值

定义是否绘制标签。如果这是 false，则其他所有标签属性都不会生效。

lightColor : 颜色

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

lightStrength : 实数

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

此值影响 Scene3D 中指定的光。

multiHighlightColor : 颜色

选中对象的高亮颜色。如果 selectionMode 设置了 AbstractGraph3D.SelectionRow 或 AbstractGraph3D.SelectionColumn 标志，则使用。

multiHighlightGradient : 渐变

选中对象的高亮渐变。如果 selectionMode 设置了 AbstractGraph3D.SelectionRow 或 AbstractGraph3D.SelectionColumn 标志，则使用。

shadowStrength : 实数

整个图的阴影强度。数值越高，阴影越暗。值必须在 0.0 和 100.0 之间。

此值影响 Scene3D 中指定的光。

singleHighlightColor : 颜色

选中对象的高亮颜色。如果 selectionMode 设置了 AbstractGraph3D.SelectionItem 标志，则使用。

singleHighlightGradient : 渐变

选中对象的高亮渐变。如果 selectionMode 设置了 AbstractGraph3D.SelectionItem 标志，则使用。

type : Theme3D.Theme

主题的类型。如果没有设置类型，则类型为 Theme3D.Theme.UserDefined。在构建项目后更改主题类型将更改主题的所有其他属性为预定义主题指定的属性。更改图形活动的主题类型也会重置所有附加的系列以使用新主题。

windowColor : 颜色

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