Q3DTheme Class

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

Creating a built-in theme without any modifications:

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

Creating a built-in theme and modifying some properties:

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

Creating a user-defined theme:

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)));

Creating a built-in theme and modifying some properties after it has been set:

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

Color styles.

Built-in themes.

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.

The value must be between 0.0f and 1.0f.

Access functions:

• float ambientLightStrength() const

• void setAmbientLightStrength(float strength)

Notifier signal:

• void ambientLightStrengthChanged(float strength)

This property holds the color of the graph background.

Access functions:

• backgroundColor() const

• void setBackgroundColor(const &color)

Notifier signal:

• void backgroundColorChanged(const &color)

This property holds whether the background is visible.

The background is drawn by using the value of backgroundColor.

Access functions:

• bool isBackgroundEnabled() const

• void setBackgroundEnabled(bool enabled)

Notifier signal:

• void backgroundEnabledChanged(bool enabled)

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 is not ColorStyleUniform.

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

Access functions:

• <> baseColors() const

• void setBaseColors(const <> &colors)

Notifier signal:

• void baseColorsChanged(const <> &colors)

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.

Access functions:

• <> baseGradients() const

• void setBaseGradients(const <> &gradients)

Notifier signal:

• void baseGradientsChanged(const <> &gradients)

This property holds the style of the graph colors.

One of the ColorStyle enum values.

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

Access functions:

• colorStyle() const

• void setColorStyle( style)

Notifier signal:

• void colorStyleChanged( style)

This property holds the font to be used for labels.

Access functions:

• font() const

• void setFont(const &font)

Notifier signal:

• void fontChanged(const &font)

This property holds whether the grid lines are drawn.

This value affects all grid lines.

Access functions:

• bool isGridEnabled() const

• void setGridEnabled(bool enabled)

Notifier signal:

• void gridEnabledChanged(bool enabled)

This property holds the color of the grid lines.

Access functions:

• gridLineColor() const

• void setGridLineColor(const &color)

Notifier signal:

• void gridLineColorChanged(const &color)

This property holds the specular light strength for selected objects.

The value must be between 0.0f and 10.0f.

Access functions:

• float highlightLightStrength() const

• void setHighlightLightStrength(float strength)

Notifier signal:

• void highlightLightStrengthChanged(float strength)

This property holds the color of the label backgrounds.

Has no effect if labelBackgroundEnabled is false.

Access functions:

• labelBackgroundColor() const

• void setLabelBackgroundColor(const &color)

Notifier signal:

• void labelBackgroundColorChanged(const &color)

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.

Access functions:

• bool isLabelBackgroundEnabled() const

• void setLabelBackgroundEnabled(bool enabled)

Notifier signal:

• void labelBackgroundEnabledChanged(bool enabled)

This property holds whether label borders are drawn for labels that have a background.

Has no effect if labelBackgroundEnabled is false.

Access functions:

• bool isLabelBorderEnabled() const

• void setLabelBorderEnabled(bool enabled)

Notifier signal:

• void labelBorderEnabledChanged(bool enabled)

This property holds the color of the font used for labels.

Access functions:

• labelTextColor() const

• void setLabelTextColor(const &color)

Notifier signal:

• void labelTextColorChanged(const &color)

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

This value affects the light specified in Q3DScene.

Access functions:

• lightColor() const

• void setLightColor(const &color)

Notifier signal:

• void lightColorChanged(const &color)

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

The value must be between 0.0f and 10.0f.

This value affects the light specified in Q3DScene.

Access functions:

• float lightStrength() const

• void setLightStrength(float strength)

Notifier signal:

• void lightStrengthChanged(float strength)

This property holds the highlight color for selected objects.

Used if selectionMode has the QAbstract3DGraph::SelectionRow or QAbstract3DGraph::SelectionColumn flag set.

Access functions:

• multiHighlightColor() const

• void setMultiHighlightColor(const &color)

Notifier signal:

• void multiHighlightColorChanged(const &color)

This property holds the highlight gradient for selected objects.

Used if selectionMode has the QAbstract3DGraph::SelectionRow or QAbstract3DGraph::SelectionColumn flag set.

Access functions:

• multiHighlightGradient() const

• void setMultiHighlightGradient(const &gradient)

Notifier signal:

• void multiHighlightGradientChanged(const &gradient)

This property holds the highlight color for a selected object.

Used if selectionMode has the QAbstract3DGraph::SelectionItem flag set.

Access functions:

• singleHighlightColor() const

• void setSingleHighlightColor(const &color)

Notifier signal:

• void singleHighlightColorChanged(const &color)

This property holds the highlight gradient for a selected object.

Used if selectionMode has the QAbstract3DGraph::SelectionItem flag set.

Access functions:

• singleHighlightGradient() const

• void setSingleHighlightGradient(const &gradient)

Notifier signal:

• void singleHighlightGradientChanged(const &gradient)

This property holds the type of the 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.

Access functions:

• type() const

• void setType( themeType)

Notifier signal:

• void typeChanged( themeType)

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

Access functions:

• windowColor() const

• void setWindowColor(const &color)

Notifier signal:

• void windowColorChanged(const &color)

Constructs a new theme of type ThemeUserDefined. An optional parent parameter can be given and is then passed to QObject constructor.

Constructs a new theme with themeType, which can be one of the built-in themes from Theme. An optional parent parameter can be given and is then passed to QObject constructor.

Destroys the theme.