Q3DTheme 类

Q3DTheme 类为图形提供视觉样式。 更多...

头: #include <Q3DTheme>
qmake: QT += datavisualization
Since: QtDataVisualization 1.0
实例化: Theme3D
继承: QObject

该类在 QtDataVisualization 1.0 引入。

公共类型

enum ColorStyle { ColorStyleUniform, ColorStyleObjectGradient, ColorStyleRangeGradient }
enum Theme { ThemeQt, ThemePrimaryColors, ThemeDigia, ThemeStoneMoss, ThemeArmyBlue, …, ThemeUserDefined }

特性

公共函数

Q3DTheme (Q3DTheme::Theme themeType , QObject * parent = nullptr)
Q3DTheme (QObject * parent = nullptr)
virtual ~Q3DTheme ()
float ambientLightStrength () const
QColor backgroundColor () const
QList<QColor> baseColors () const
QList<QLinearGradient> baseGradients () const
Q3DTheme::ColorStyle colorStyle () const
QFont font () const
QColor gridLineColor () const
float highlightLightStrength () const
bool isBackgroundEnabled () const
bool isGridEnabled () const
bool isLabelBackgroundEnabled () const
bool isLabelBorderEnabled () const
QColor labelBackgroundColor () const
QColor labelTextColor () const
QColor lightColor () const
float lightStrength () const
QColor multiHighlightColor () const
QLinearGradient multiHighlightGradient () const
void setAmbientLightStrength (float strength )
void setBackgroundColor (const QColor & color )
void setBackgroundEnabled (bool enabled )
void setBaseColors (const QList<QColor> & colors )
void setBaseGradients (const QList<QLinearGradient> & gradients )
void setColorStyle (Q3DTheme::ColorStyle style )
void setFont (const QFont & font )
void setGridEnabled (bool enabled )
void setGridLineColor (const QColor & color )
void setHighlightLightStrength (float strength )
void setLabelBackgroundColor (const QColor & color )
void setLabelBackgroundEnabled (bool enabled )
void setLabelBorderEnabled (bool enabled )
void setLabelTextColor (const QColor & color )
void setLightColor (const QColor & color )
void setLightStrength (float strength )
void setMultiHighlightColor (const QColor & color )
void setMultiHighlightGradient (const QLinearGradient & gradient )
void setSingleHighlightColor (const QColor & color )
void setSingleHighlightGradient (const QLinearGradient & gradient )
void setType (Q3DTheme::Theme themeType )
void setWindowColor (const QColor & color )
QColor singleHighlightColor () const
QLinearGradient singleHighlightGradient () const
Q3DTheme::Theme type () const
QColor windowColor () const

信号

void ambientLightStrengthChanged (float strength )
void backgroundColorChanged (const QColor & color )
void backgroundEnabledChanged (bool enabled )
void baseColorsChanged (const QList<QColor> & colors )
void baseGradientsChanged (const QList<QLinearGradient> & gradients )
void colorStyleChanged (Q3DTheme::ColorStyle style )
void fontChanged (const QFont & font )
void gridEnabledChanged (bool enabled )
void gridLineColorChanged (const QColor & color )
void highlightLightStrengthChanged (float strength )
void labelBackgroundColorChanged (const QColor & color )
void labelBackgroundEnabledChanged (bool enabled )
void labelBorderEnabledChanged (bool enabled )
void labelTextColorChanged (const QColor & color )
void lightColorChanged (const QColor & color )
void lightStrengthChanged (float strength )
void multiHighlightColorChanged (const QColor & color )
void multiHighlightGradientChanged (const QLinearGradient & gradient )
void singleHighlightColorChanged (const QColor & color )
void singleHighlightGradientChanged (const QLinearGradient & gradient )
void typeChanged (Q3DTheme::Theme themeType )
void windowColorChanged (const QColor & color )

详细描述

指定影响整个图形的视觉特性。有几个内置主题可以使用或自由修改。

可以覆写以下特性通过使用 QAbstract3DSeries 特性以按系列明确设置它们: baseColors , baseGradients ,和 colorStyle .

可以从新创建主题使用 ThemeUserDefined 枚举值。使用默认构造函数创建主题会产生新的用户定义主题。

默认主题

The following table lists the properties controlled by themes and the default values for ThemeUserDefined .

特性 默认值
ambientLightStrength 0.25
backgroundColor Qt::black
backgroundEnabled true
baseColors Qt::black
baseGradients QLinearGradient 。本质上全黑。
colorStyle ColorStyleUniform
font QFont
gridEnabled true
gridLineColor Qt::white
highlightLightStrength 7.5
labelBackgroundColor Qt::gray
labelBackgroundEnabled true
labelBorderEnabled true
labelTextColor Qt::white
lightColor Qt::white
lightStrength 5.0
multiHighlightColor Qt::blue
multiHighlightGradient QLinearGradient 。本质上全黑。
singleHighlightColor Qt::red
singleHighlightGradient QLinearGradient 。本质上全黑。
windowColor Qt::black

用法范例

创建内置主题不做任何修改:

Q3DTheme *theme = new Q3DTheme(Q3DTheme::ThemeQt);
					

创建内置主题并修改一些特性:

Q3DTheme *theme = new Q3DTheme(Q3DTheme::ThemeQt);
theme->setBackgroundEnabled(false);
theme->setLabelBackgroundEnabled(false);
					

创建用户定义主题:

Q3DTheme *theme = new Q3DTheme();
theme->setAmbientLightStrength(0.3f);
theme->setBackgroundColor(QColor(QRgb(0x99ca53)));
theme->setBackgroundEnabled(true);
theme->setBaseColor(QColor(QRgb(0x209fdf)));
theme->setColorStyle(Q3DTheme::ColorStyleUniform);
theme->setFont(QFont(QStringLiteral("Impact"), 35));
theme->setGridEnabled(true);
theme->setGridLineColor(QColor(QRgb(0x99ca53)));
theme->setHighlightLightStrength(7.0f);
theme->setLabelBackgroundColor(QColor(0xf6, 0xa6, 0x25, 0xa0));
theme->setLabelBackgroundEnabled(true);
theme->setLabelBorderEnabled(true);
theme->setLabelTextColor(QColor(QRgb(0x404044)));
theme->setLightColor(Qt::white);
theme->setLightStrength(6.0f);
theme->setMultiHighlightColor(QColor(QRgb(0x6d5fd5)));
theme->setSingleHighlightColor(QColor(QRgb(0xf6a625)));
theme->setWindowColor(QColor(QRgb(0xffffff)));
					

创建内置主题并在设置后修改一些特性:

Q3DBars *graph = new Q3DBars();
graph->activeTheme()->setType(Q3DTheme::ThemePrimaryColors);
graph->activeTheme()->setBaseColor(Qt::red);
graph->activeTheme()->setSingleHighlightColor(Qt::yellow);
					

成员类型文档编制

enum Q3DTheme:: ColorStyle

颜色样式。

常量 描述
Q3DTheme::ColorStyleUniform 0 Objects are rendered in a single color. The color used is specified in baseColors , singleHighlightColor and multiHighlightColor 特性。
Q3DTheme::ColorStyleObjectGradient 1 Objects are colored using a full gradient for each object regardless of object height. The gradient used is specified in baseGradients , singleHighlightGradient and multiHighlightGradient 特性。
Q3DTheme::ColorStyleRangeGradient 2 Objects are colored using a portion of the full gradient determined by the object's height and its position on the Y-axis. The gradient used is specified in baseGradients , singleHighlightGradient and multiHighlightGradient 特性。

enum Q3DTheme:: Theme

内置主题。

常量 描述
Q3DTheme::ThemeQt 0 A light theme with green as the base color.
Q3DTheme::ThemePrimaryColors 1 A light theme with yellow as the base color.
Q3DTheme::ThemeDigia 2 A light theme with gray as the base color.
Q3DTheme::ThemeStoneMoss 3 A medium dark theme with yellow as the base color.
Q3DTheme::ThemeArmyBlue 4 A medium light theme with blue as the base color.
Q3DTheme::ThemeRetro 5 A medium light theme with brown as the base color.
Q3DTheme::ThemeEbony 6 A dark theme with white as the base color.
Q3DTheme::ThemeIsabelle 7 A dark theme with yellow as the base color.
Q3DTheme::ThemeUserDefined 8 A user-defined theme. For more information, see 默认主题 .

特性文档编制

ambientLightStrength : float

This property holds the ambient light strength for the whole graph.

This value determines how evenly and brightly the colors are shown throughout the graph regardless of the light position.

值必须介于 0.0f and 1.0f .

访问函数:

float ambientLightStrength () const
void setAmbientLightStrength (float strength )

通知程序信号:

void ambientLightStrengthChanged (float strength )

backgroundColor : QColor

此特性保持图形背景的颜色。

访问函数:

QColor backgroundColor () const
void setBackgroundColor (const QColor & color )

通知程序信号:

void backgroundColorChanged (const QColor & color )

backgroundEnabled : bool

此特性保持背景是否可见。

The background is drawn by using the value of backgroundColor .

访问函数:

bool isBackgroundEnabled () const
void setBackgroundEnabled (bool enabled )

通知程序信号:

void backgroundEnabledChanged (bool enabled )

baseColors : QList < QColor >

This property holds the list of base colors to be used for all the objects in the graph, series by series.

If there are more series than colors, the color list wraps and starts again with the first color in the list.

Has no immediate effect if colorStyle 不是 ColorStyleUniform .

This value can be overridden by setting the baseColor explicitly in the series.

访问函数:

QList<QColor> baseColors () const
void setBaseColors (const QList<QColor> & colors )

通知程序信号:

void baseColorsChanged (const QList<QColor> & colors )

baseGradients : QList < QLinearGradient >

This property holds the list of base gradients to be used for all the objects in the graph, series by series.

If there are more series than gradients, the gradient list wraps and starts again with the first gradient in the list

Has no immediate effect if colorStyle is ColorStyleUniform .

This value can be overridden by setting the baseGradient explicitly in the series.

访问函数:

QList<QLinearGradient> baseGradients () const
void setBaseGradients (const QList<QLinearGradient> & gradients )

通知程序信号:

void baseGradientsChanged (const QList<QLinearGradient> & gradients )

colorStyle : ColorStyle

此特性保持图形颜色的样式。

One of the ColorStyle 枚举值。

This value can be overridden by setting colorStyle explicitly in the series.

访问函数:

Q3DTheme::ColorStyle colorStyle () const
void setColorStyle (Q3DTheme::ColorStyle style )

通知程序信号:

void colorStyleChanged (Q3DTheme::ColorStyle style )

font : QFont

此特性保持用于标签的字体。

访问函数:

QFont font () const
void setFont (const QFont & font )

通知程序信号:

void fontChanged (const QFont & font )

gridEnabled : bool

此特性保持是否绘制栅格线。

此值影响所有栅格线。

访问函数:

bool isGridEnabled () const
void setGridEnabled (bool enabled )

通知程序信号:

void gridEnabledChanged (bool enabled )

gridLineColor : QColor

此特性保持栅格线的颜色。

访问函数:

QColor gridLineColor () const
void setGridLineColor (const QColor & color )

通知程序信号:

void gridLineColorChanged (const QColor & color )

highlightLightStrength : float

此特性保持用于选中对象的镜面光强度。

值必须介于 0.0f and 10.0f .

访问函数:

float highlightLightStrength () const
void setHighlightLightStrength (float strength )

通知程序信号:

void highlightLightStrengthChanged (float strength )

labelBackgroundColor : QColor

此特性保持标签背景的颜色。

不起作用若 labelBackgroundEnabled is false .

访问函数:

QColor labelBackgroundColor () const
void setLabelBackgroundColor (const QColor & color )

通知程序信号:

void labelBackgroundColorChanged (const QColor & color )

labelBackgroundEnabled : bool

This property holds whether the label is drawn with a color background or with a fully transparent background.

The labelBackgroundColor value (including alpha) is used for drawing the background.

Labels with a background are drawn to equal sizes per axis based on the longest label, and the text is centered in them. Labels without a background are drawn as is and are left or right aligned based on their position in the graph.

访问函数:

bool isLabelBackgroundEnabled () const
void setLabelBackgroundEnabled (bool enabled )

通知程序信号:

void labelBackgroundEnabledChanged (bool enabled )

labelBorderEnabled : bool

此特性保持是否为拥有背景的标签绘制标签边框。

不起作用若 labelBackgroundEnabled is false .

访问函数:

bool isLabelBorderEnabled () const
void setLabelBorderEnabled (bool enabled )

通知程序信号:

void labelBorderEnabledChanged (bool enabled )

labelTextColor : QColor

此特性保持用于标签的字体颜色。

访问函数:

QColor labelTextColor () const
void setLabelTextColor (const QColor & color )

通知程序信号:

void labelTextColorChanged (const QColor & color )

lightColor : QColor

This property holds the color for the ambient and specular light.

This value affects the light specified in Q3DScene .

访问函数:

QColor lightColor () const
void setLightColor (const QColor & color )

通知程序信号:

void lightColorChanged (const QColor & color )

lightStrength : float

This property holds the specular light strength for the whole graph.

值必须介于 0.0f and 10.0f .

This value affects the light specified in Q3DScene .

访问函数:

float lightStrength () const
void setLightStrength (float strength )

通知程序信号:

void lightStrengthChanged (float strength )

multiHighlightColor : QColor

This property holds the highlight color for selected objects.

Used if selectionMode 拥有 QAbstract3DGraph::SelectionRow or QAbstract3DGraph::SelectionColumn 设置标志。

访问函数:

QColor multiHighlightColor () const
void setMultiHighlightColor (const QColor & color )

通知程序信号:

void multiHighlightColorChanged (const QColor & color )

multiHighlightGradient : QLinearGradient

This property holds the highlight gradient for selected objects.

Used if selectionMode 拥有 QAbstract3DGraph::SelectionRow or QAbstract3DGraph::SelectionColumn 设置标志。

访问函数:

QLinearGradient multiHighlightGradient () const
void setMultiHighlightGradient (const QLinearGradient & gradient )

通知程序信号:

void multiHighlightGradientChanged (const QLinearGradient & gradient )

singleHighlightColor : QColor

This property holds the highlight color for a selected object.

Used if selectionMode 拥有 QAbstract3DGraph::SelectionItem 设置标志。

访问函数:

QColor singleHighlightColor () const
void setSingleHighlightColor (const QColor & color )

通知程序信号:

void singleHighlightColorChanged (const QColor & color )

singleHighlightGradient : QLinearGradient

This property holds the highlight gradient for a selected object.

Used if selectionMode 拥有 QAbstract3DGraph::SelectionItem 设置标志。

访问函数:

QLinearGradient singleHighlightGradient () const
void setSingleHighlightGradient (const QLinearGradient & gradient )

通知程序信号:

void singleHighlightGradientChanged (const QLinearGradient & gradient )

type : Theme

此特性保持主题的类型。

The type is automatically set when constructing a theme, but can also be changed later. Changing the theme type will change all other properties of the theme to what the predefined theme specifies. Changing the theme type of the active theme of the graph will also reset all attached series to use the new theme.

访问函数:

Q3DTheme::Theme type () const
void setType (Q3DTheme::Theme themeType )

通知程序信号:

void typeChanged (Q3DTheme::Theme themeType )

windowColor : QColor

This property holds the color of the application window the graph is drawn into.

访问函数:

QColor windowColor () const
void setWindowColor (const QColor & color )

通知程序信号:

void windowColorChanged (const QColor & color )

成员函数文档编制

Q3DTheme:: Q3DTheme ( Q3DTheme::Theme themeType , QObject * parent = nullptr)

构造新的主题采用 themeType ,可以是某一内置主题来自 Theme 。可选 parent 参数可以给出,然后会被传递给 QObject 构造函数。

Q3DTheme:: Q3DTheme ( QObject * parent = nullptr)

构造新主题为类型 ThemeUserDefined 。可选 parent 参数可以给出,然后会被传递给 QObject 构造函数。

[虚拟] Q3DTheme:: ~Q3DTheme ()

销毁主题。