このページでは

GraphsTheme QML Type

グラフの視覚的スタイル。詳細...

Import Statement: import QtGraphs
In C++: QGraphsTheme

プロパティ

詳細説明

このタイプは、グラフ全体に影響を与える視覚的なプロパティを指定するために使用されます。そのまま使用することも、自由に変更することもできる組み込みのテーマがいくつか用意されています。

GraphsTheme.Theme.UserDefined 列挙型の値を使用することで、テーマをゼロから作成することもできます。

テーマのカスタマイズ

デフォルトのテーマは QtGreen ですが、各プロパティをカスタマイズすることができます。

次の表は、テーマによって制御されるプロパティと、QGraphsTheme.Theme.UserDefined のデフォルト値の一覧です。

プロパティデフォルト値
backgroundVisibletrue
seriesColorsQt::black
baseGradientsQLinearGradient。実質的に完全な黒です。
colorStyleUniform
labelFontQFont
gridVisibletrue
labelBackgroundVisibletrue
labelBorderVisibletrue
labelsVisibletrue

使用例

変更を加えずに組み込みテーマを使用する場合:

Scatter3D {
    theme: GraphsTheme { theme: GraphsTheme.Theme.YellowSeries }
    ...

組み込みテーマを使用し、一部のプロパティを変更する場合:

Bars3D {
    theme: GraphsTheme {
        theme: GraphsTheme.Theme.QtGreenNeon
        labelBorderVisible: true
        labelFont.pointSize: 35
        labelBackgroundVisible: false
    }
    ...

ユーザー定義のテーマを使用する場合:

Surface3D {
    theme: GraphsTheme {
        theme: GraphsTheme.Theme.UserDefined
        backgroundColor: "red"
        backgroundVisible: true
        seriesColors: ["blue"]
        colorStyle: GraphsTheme.ColorStyle.Uniform
        labelFont.family: "Lucida Handwriting"
        labelFont.pointSize: 35
        gridVisible: false
        grid.mainColor: "red"
        grid.subColor: "blue"
        labelBackgroundColor: "black"
        labelBackgroundVisible: true
        labelBorderVisible: false
        labelTextColor: "white"
        multiHighlightColor: "green"
        singleHighlightColor: "darkRed"
    }
    ...

GraphsTheme の列挙型については、GraphsTheme::colorStyle およびGraphsTheme::theme を参照してください。

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

GraphsLine.labelTextColor : color

ラベルに使用されるテキストの色。デフォルト値は、colorScheme の設定によって異なります。

GraphsLine.mainColor : color

メインラインの色。デフォルト値は、colorScheme の設定によって異なります。

GraphsLine.mainWidth : real

主線の幅。デフォルト値は2.0 です。

グリッド線に対して設定された場合、GraphsItem3D::gridLineType がGraphs3D.GridLineType.Shader

「Graphs3D.GridLineType」も参照してください 。

GraphsLine.subColor : color

サブラインの色。デフォルト値はcolorScheme の設定によって異なります。

GraphsLine.subWidth : real

補助線の幅。デフォルト値は1.0 です。

グリッド線に対して設定された場合、GraphsItem3D::gridLineType がGraphs3D.GridLineType.Shader

「Graphs3D.GridLineType」も参照してください 。

axisX : GraphsLine

X軸のGraphsLine を保持します。

GraphsLine.mainColor 、GraphsLine.subColor 、GraphsLine.mainWidth 、GraphsLine.subWidth 、およびGraphsLine.labelTextColorも参照してください 。

axisXLabelFont : font

axisX のラベルに使用するフォントを設定します。

axisY : GraphsLine

Y軸のGraphsLine を保持します。

「 GraphsLine.mainColor 」、「GraphsLine.subColor 」、「GraphsLine.mainWidth 」、「GraphsLine.subWidth 」、および「GraphsLine.labelTextColor 」も参照してください 。

axisYLabelFont : font

axisY のラベルに使用するフォントを設定します。

axisZ : GraphsLine

Z軸のGraphsLine を保持します。

「 GraphsLine.mainColor 」、「GraphsLine.subColor 」、「GraphsLine.mainWidth 」、「GraphsLine.subWidth 」、および「GraphsLine.labelTextColor 」も参照してください 。

axisZLabelFont : font

axisZ のラベルに使用するフォントを設定します。

backgroundColor : color

グラフが描画されるビューの色。デフォルト値は、colorScheme の設定によって異なります。

backgroundVisible : bool

ビューの背景をbackgroundColor の値を使用して描画するかどうかを指定します。デフォルト値はtrue です。

baseColors : list<Color> [read-only]

グラフ内のすべてのオブジェクトに対して、シリーズごとに使用される、型「Color」の基本色のリストです。シリーズの数が色の数より多い場合、色リストはループして、リストの最初の色から再び繰り返されます。colorStyle がGraphsTheme.ColorStyle.Uniform でない場合、この設定は直ちには反映されません。

使用例:

baseColors: [ Color { color: "red" } ]

これは、シリーズ内でAbstract3DSeries.baseColor を明示的に設定することで上書きできます。

baseGradients : list<Gradient> [read-only]

グラフ内のすべてのオブジェクトに対して、シリーズごとに使用されるベースグラデーションの一覧です。シリーズの数よりグラデーションの数が多い場合、グラデーションの一覧はループし、リストの最初のグラデーションから再び開始されます。

colorStyle がGraphsTheme.ColorStyle.Uniform に設定されている場合、直ちには効果が現れません。

使用例:

baseGradients: [ Gradient {
    GradientStop { position: 1.0; color: "#DBEB00" }
    GradientStop { position: 0.0; color: "#373F26" }
} ]

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

borderColors : list<color>

グラフ内のすべてのオブジェクトに適用される枠線の色のリスト(シリーズごとに指定)。

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

colorStyle がUniformでない場合、この設定は直ちには反映されません。

colorScheme : QGraphsTheme::ColorScheme

使用中のグラフの配色。

QGraphsTheme::ColorSchemeも参照してください 。

colorStyle : GraphsTheme.ColorStyle

グラフの色のスタイル。QGraphsTheme::ColorStyle 列挙型の値のいずれかです。

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

注:この プロパティは、2DのQt Graphs では効果がありません。

「QGraphsTheme::ColorStyle」も参照してください 。

grid : GraphsLine

テーマのGraphsLine を保持します。

GraphsLine.mainColor 、GraphsLine.subColor 、GraphsLine.mainWidth 、GraphsLine.subWidth 、およびGraphsLine.labelTextColorも参照してください 。

gridVisible : bool

グリッド線が描画されるかどうかを指定します。この値はすべてのグリッド線に適用されます。デフォルト値はtrue です。

labelBackgroundColor : color

ラベルの背景色です。labelBackgroundVisible がfalse に設定されている場合は、この設定は効果を持ちません。デフォルト値はcolorScheme の設定によって異なります。

labelBackgroundVisible : bool

ラベルを、labelBackgroundColor (アルファ値を含む)を使用した背景で描画するか、完全に透明な背景で描画するかを指定します。 背景を持つラベルは、各軸ごとに最も長いラベルに基づいて均等なサイズで描画され、テキストはその中央に配置されます。背景を持たないラベルはそのまま描画され、グラフ内での位置に基づいて左揃えまたは右揃えになります。デフォルト値はtrue です。

labelBorderVisible : bool

背景色を持つラベルに対して、ラベルの枠線を表示するかどうかを指定します。labelBackgroundVisible がfalse に設定されている場合は、この設定は効果を持ちません。デフォルト値はtrue です。

labelFont : font

ラベルに使用するフォントを設定します。

labelTextColor : color

ラベルに使用されるフォントの色。

軸にlabelTextColor が明示的に指定されている場合、この設定は効果を持ちません。

デフォルト値はcolorScheme によって異なります。

labelsVisible : bool

ラベルを描画するかどうかを指定します。これがfalse の場合、他のすべてのラベルのプロパティは有効になりません。デフォルト値はtrue です。

multiHighlightColor : color

選択されたオブジェクトのハイライト色。selectionMode に「Graphs3D.SelectionFlag.Row 」または「Graphs3D.SelectionFlag.Column 」フラグが設定されている場合に使用されます。デフォルト値はcolorScheme によって異なります。

Graphs3D.SelectionFlagも参照してください 。

multiHighlightGradient : Gradient

選択されたオブジェクトのハイライトグラデーション。selectionMode に「Graphs3D.SelectionFlag.Row 」または「Graphs3D.SelectionFlag.Column 」フラグが設定されている場合に使用されます。デフォルト値はcolorScheme によって異なります。

Graphs3D.SelectionFlagも参照してください 。

plotAreaBackgroundColor : color

グラフのプロット領域の背景色。デフォルト値は、colorScheme の設定によって異なります。

plotAreaBackgroundVisible : bool

プロット領域の背景を、plotAreaBackgroundColor の値を使用して描画するかどうかを指定します。デフォルト値はtrue です。

seriesColors : list<color>

グラフ内のすべてのオブジェクトに適用される色のリストで、系列ごとに指定されます。色の数よりも系列の数が多い場合、色のリストはループして、リストの最初の色から再び繰り返されます。colorStyle がGraphsTheme.ColorStyle.Uniform でない場合、この設定は直ちには反映されません。

使用例:

seriesColors: [ "red" ]

これは、シリーズ内でAbstract3DSeries.baseColor を明示的に設定することで上書きできます。

singleHighlightColor : color

選択されたオブジェクトのハイライト色。selectionMode に `Graphs3D.SelectionFlag.Item ` フラグが設定されている場合に使用されます。デフォルト値はcolorScheme によって決まります。

「Graphs3D.SelectionFlag」も参照してください 。

singleHighlightGradient : Gradient

選択されたオブジェクトのハイライトグラデーション。selectionMode にGraphs3D.SelectionFlag.Item フラグが設定されている場合に使用されます。デフォルト値はcolorScheme によって決まります。

「Graphs3D.SelectionFlag」も参照してください 。

theme : GraphsTheme.Theme

テーマのタイプ。タイプが設定されていない場合、タイプはGraphsTheme.Theme.QtGreen となります。アイテムの構築後にテーマのタイプを変更すると、テーマの他のすべてのプロパティが、定義済みのテーマで指定されている値に変更されます。グラフのアクティブなテーマのタイプを変更すると、関連付けられているすべての系列もリセットされ、新しいテーマが適用されます。

© 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.