Back to Qt.io
Contact Us Blog Download Qt
このページでは

Q3DTheme Class

Q3DTheme クラスは、グラフの視覚的なスタイルを提供します。詳細...

ヘッダー: #include <Q3DTheme>
CMake: find_package(Qt6 REQUIRED COMPONENTS DataVisualization)
target_link_libraries(mytarget PRIVATE Qt6::DataVisualization)
qmake: QT += datavisualization
バージョン: QtDataVisualization 1.0
QMLでの登場: Theme3D
継承元: QObject
ステータス: 非推奨

このクラスは非推奨です。新しいコードでの使用は強く推奨しません。

パブリック型

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

プロパティ

パブリック関数

Q3DTheme(QObject *parent = nullptr)
Q3DTheme(Q3DTheme::Theme themeType, 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 列挙型の値を使用することで、テーマをゼロから作成できます。デフォルトコンストラクタを使用してテーマを作成すると、新しいユーザー定義テーマが生成されます。

デフォルトのテーマ

次の表に、テーマによって制御されるプロパティと、ThemeUserDefined のデフォルト値を示します。

プロパティデフォルト値
ambientLightStrength0.25
backgroundColorQt::black
backgroundEnabledtrue
baseColorsQt::black
baseGradientsQLinearGradient。実質的に完全に黒。
colorStyleColorStyleUniform
fontQFont
gridEnabledtrue
gridLineColorQt::white
highlightLightStrength7.5
labelBackgroundColorQt::gray
labelBackgroundEnabledtrue
labelBorderEnabledtrue
labelTextColorQt::white
lightColorQt::white
lightStrength5.0
multiHighlightColorQt::blue
multiHighlightGradientQLinearGradient. 実質的に真っ黒。
singleHighlightColorQt::red
singleHighlightGradientQLinearGradient. 実質的に完全に黒。
windowColorQt::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::ColorStyleUniform0オブジェクトは単一の色で描画されます。使用される色は、baseColors 、singleHighlightColor 、およびmultiHighlightColor プロパティで指定されます。
Q3DTheme::ColorStyleObjectGradient1オブジェクトの高さに関係なく、各オブジェクトに完全なグラデーションが適用されます。使用されるグラデーションは、baseGradients 、singleHighlightGradient 、およびmultiHighlightGradient プロパティで指定されます。
Q3DTheme::ColorStyleRangeGradient2オブジェクトは、その高さと Y 軸上の位置によって決定されるフルグラデーションの一部を使用して着色されます。使用されるグラデーションは、baseGradients 、singleHighlightGradient 、およびmultiHighlightGradient プロパティで指定されます。

enum Q3DTheme::Theme

組み込みテーマ。

定数値説明
Q3DTheme::ThemeQt0ベースカラーが緑の明るいテーマ。
Q3DTheme::ThemePrimaryColors1黄色を基調色とした明るいテーマ。
Q3DTheme::ThemeDigia2ベースカラーにグレーを使用した明るいテーマ。
Q3DTheme::ThemeStoneMoss3黄色を基調とした中程度の暗さのテーマ。
Q3DTheme::ThemeArmyBlue4青を基調色とした中程度の明るいテーマ。
Q3DTheme::ThemeRetro5茶色を基調とした中程度の明るいテーマ。
Q3DTheme::ThemeEbony6白を基調としたダークテーマ。
Q3DTheme::ThemeIsabelle7黄色をベースカラーとするダークテーマ。
Q3DTheme::ThemeUserDefined8ユーザー定義のテーマ。詳細については、Default Theme を参照してください。

プロパティのドキュメント

ambientLightStrength : float

このプロパティは、グラフ全体の周囲光の強度を指定します。

この値によって、光の位置にかかわらず、グラフ全体で色がどれほど均一かつ明るく表示されるかが決まります。

値は、0.0f から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

このプロパティは、背景が表示されているかどうかにかかわらず有効です。

背景は、backgroundColor の値を使用して描画されます。

アクセス関数：

bool isBackgroundEnabled() const
void setBackgroundEnabled(bool enabled)

通知シグナル:

void backgroundEnabledChanged(bool enabled)

baseColors : QList<QColor>

このプロパティには、グラフ内のすべてのオブジェクトに対して、シリーズごとに使用される基本色のリストが格納されます。

色の数よりも系列の数が多い場合、色リストは折り返され、リストの最初の色から再び繰り返されます。

colorStyle がColorStyleUniform でない場合、このプロパティは即座には効果を発揮しません。

baseColor が でない場合、この値は即座に反映されません。この値は、シリーズ内で を明示的に設定することで上書きできます。

アクセス関数：

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

通知シグナル：

void baseColorsChanged(const QList<QColor> &colors)

baseGradients : QList<QLinearGradient>

このプロパティには、グラフ内のすべてのオブジェクトに対して、シリーズごとに使用される基本グラデーションのリストが格納されます。

系列の数よりグラデーションの数が多い場合、グラデーションのリストは折り返され、リストの最初のグラデーションから再び開始されます

colorStyle がColorStyleUniform に設定されている場合、このプロパティは即座には効果を発揮しません。

baseGradient が に設定されている場合、この値は直ちには効果を発揮しません。この値は、シリーズ内で を明示的に設定することで上書きできます。

アクセス関数:

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

通知シグナル：

void baseGradientsChanged(const QList<QLinearGradient> &gradients)

colorStyle : ColorStyle

このプロパティは、グラフの色に関するスタイルを保持します。

ColorStyle 列挙型の値のいずれかです。

この値は、シリーズ内でcolorStyle を明示的に設定することで上書きできます。

アクセス関数：

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)

Notifierシグナル：

void gridLineColorChanged(const QColor &color)

highlightLightStrength : float

このプロパティには、選択されたオブジェクトの鏡面反射の光強度が格納されます。

値は、0.0f から10.0f の範囲で指定する必要があります。

アクセス関数：

float highlightLightStrength() const
void setHighlightLightStrength(float strength)

通知シグナル：

void highlightLightStrengthChanged(float strength)

labelBackgroundColor : QColor

このプロパティは、ラベルの背景色を指定します。

labelBackgroundEnabled がfalse に設定されている場合、このプロパティは効果を持ちません。

アクセス関数：

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

通知シグナル:

void labelBackgroundColorChanged(const QColor &color)

labelBackgroundEnabled : bool

このプロパティは、ラベルが色付きの背景で描画される場合でも、完全に透明な背景で描画される場合でも有効です。

背景の描画には、labelBackgroundColor の値（アルファ値を含む）が使用されます。

背景を持つラベルは、最も長いラベルを基準として各軸ごとに均等なサイズで描画され、テキストはその中央に配置されます。背景を持たないラベルはそのまま描画され、グラフ内での位置に基づいて左揃えまたは右揃えになります。

アクセス関数:

bool isLabelBackgroundEnabled() const
void setLabelBackgroundEnabled(bool enabled)

通知シグナル：

void labelBackgroundEnabledChanged(bool enabled)

labelBorderEnabled : bool

このプロパティは、背景を持つラベルに対してラベルの境界線が描画されるかどうかを指定します。

labelBackgroundEnabled が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

このプロパティは、アンビエント光およびスペキュラー光の色を指定します。

この値は、Q3DSceneで指定された光に影響を与えます。

アクセス関数：

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

通知シグナル：

void lightColorChanged(const QColor &color)

lightStrength : float

このプロパティは、グラフ全体の鏡面反射光の強度を保持します。

値は、0.0f から10.0f の範囲で指定する必要があります。

この値は、Q3DSceneで指定された照明に影響を与えます。

アクセス関数：

float lightStrength() const
void setLightStrength(float strength)

通知シグナル：

void lightStrengthChanged(float strength)

multiHighlightColor : QColor

このプロパティは、選択されたオブジェクトのハイライト色を保持します。

selectionMode に「QAbstract3DGraph::SelectionRow 」または「QAbstract3DGraph::SelectionColumn 」フラグが設定されている場合に使用されます。

アクセス関数：

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

通知シグナル:

void multiHighlightColorChanged(const QColor &color)

multiHighlightGradient : QLinearGradient

このプロパティは、選択されたオブジェクトのハイライトのグラデーションを保持します。

selectionMode に「QAbstract3DGraph::SelectionRow 」または「QAbstract3DGraph::SelectionColumn 」フラグが設定されている場合に使用されます。

アクセス関数:

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

通知シグナル:

void multiHighlightGradientChanged(const QLinearGradient &gradient)

singleHighlightColor : QColor

このプロパティは、選択されたオブジェクトのハイライト色を保持します。

selectionMode にQAbstract3DGraph::SelectionItem フラグが設定されている場合に使用されます。

アクセス関数：

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

通知シグナル:

void singleHighlightColorChanged(const QColor &color)

singleHighlightGradient : QLinearGradient

このプロパティは、選択されたオブジェクトのハイライトのグラデーションを保持します。

selectionMode にQAbstract3DGraph::SelectionItem フラグが設定されている場合に使用されます。

アクセス関数：

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

通知シグナル:

void singleHighlightGradientChanged(const QLinearGradient &gradient)

type : Theme

このプロパティは、テーマのタイプを保持します。

この型はテーマの生成時に自動的に設定されますが、後から変更することも可能です。テーマの型を変更すると、テーマの他のすべてのプロパティが、事前定義されたテーマで指定されている値に変更されます。グラフのアクティブなテーマの型を変更すると、関連付けられているすべての系列もリセットされ、新しいテーマが適用されます。

アクセス関数：

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

通知シグナル：

void typeChanged(Q3DTheme::Theme themeType)

windowColor : QColor

このプロパティは、グラフが描画されるアプリケーションウィンドウの色を保持します。

アクセス関数：

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

通知シグナル:

void windowColorChanged(const QColor &color)

メンバ関数のドキュメント

[explicit] Q3DTheme::Q3DTheme(QObject *parent = nullptr)

ThemeUserDefined 型の新しいテーマを作成します。オプションのparent パラメータを指定することができ、指定された場合はQObject のコンストラクタに渡されます。

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

themeType を使用して新しいテーマを作成します。この値は、Theme に記載されている組み込みテーマのいずれかです。オプションのparent パラメータを指定することも可能で、指定された場合はQObject のコンストラクタに渡されます。

[virtual noexcept] Q3DTheme::~Q3DTheme()

テーマの雰囲気を台無しにしてしまう。

© 2026 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.