このページでは

GraphsTheme QML Type

グラフの視覚的スタイル。もっと見る...

Import Statement: import QtGraphs
In C++: QGraphsTheme

プロパティ

詳細説明

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

テーマは、GraphsTheme.Theme.UserDefined enum値を使ってゼロから作成することもできる。

テーマのカスタマイズ

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

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

使用例

組み込みテーマを何も変更せずに使用する:

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型の基本色のリストを、系列ごとに指定します。系列が色より多い場合、色リストは折り返し、リストの最初の色から再スタートする。colorStyleGraphsTheme.ColorStyle.Uniform でない場合、即座に効果はない。

使用例:

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

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

baseGradients : list<Gradient> [read-only]

グラフ内のすべてのオブジェクトに使用される基本グラデーションのリスト。シリーズがグラデーションより多い場合、グラデーションリストは折り返し、リストの最初のグラデーションから再スタートする。

colorStyleGraphsTheme.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 enum値の1つ。

この値は、Abstract3DSeries.colorStyle をシリーズで明示的に設定することでオーバーライドできる。

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

QGraphsTheme::ColorStyleも参照

grid : GraphsLine

テーマのGraphsLine を保持する。

GraphsLine.mainColor,GraphsLine.subColor,GraphsLine.mainWidth,GraphsLine.subWidth,GraphsLine.labelTextColorも参照のこと

gridVisible : bool

グリッド線を描画するかどうかを定義する。この値はすべてのグリッド線に影響します。デフ ォル ト 値はtrue です。

labelBackgroundColor : color

ラベルの背景色。labelBackgroundVisiblefalse の場合は影響しません。デフォルト値はcolorScheme に依存します。

labelBackgroundVisible : bool

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

labelBorderVisible : bool

背景を持つラベルにラベルボーダーを描くかどうかを定義する。labelBackgroundVisiblefalse の場合、何の効果もありません。デフ ォル ト 値はtrue です。

labelFont : font

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

labelTextColor : color

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

軸がlabelTextColor を明示的に指定している場合、これは影響しません。

既定値はcolorScheme に依存します。

labelsVisible : bool

ラベルを全く描画しないかどうかを定義する。こ れがfalse の場合、 他のすべての ラ ベルプ ロパテ ィ は効力を持たない。デフ ォル ト 値はtrue です。

multiHighlightColor : color

選択オブジェクトのハイライト色。selectionModeGraphs3D.SelectionFlag.Row またはGraphs3D.SelectionFlag.Column フラグが設定されている場合に使用される。デフォルト値はcolorScheme に依存します。

Graphs3D.SelectionFlagも参照

multiHighlightGradient : Gradient

選択オブジェクトのハイライトグラデーション。selectionModeGraphs3D.SelectionFlag.Row またはGraphs3D.SelectionFlag.Column フラグが設定されている場合に使用されます。デフォルト値はcolorScheme に依存します。

Graphs3D.SelectionFlagも参照

plotAreaBackgroundColor : color

グラフプロット領域の背景色。デフォルト値はcolorScheme に依存する。

plotAreaBackgroundVisible : bool

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

seriesColors : list<color>

グラフ内のすべてのオブジェクトに使用する色のリストを、系列ごとに指定します。系列が色より多い場合、色リストは折り返し、リストの最初の色から再スタートする。colorStyleGraphsTheme.ColorStyle.Uniform でない場合、即座に効果はありません。

使用例:

seriesColors: [ "red" ]

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

singleHighlightColor : color

選択オブジェクトのハイライト色。selectionModeGraphs3D.SelectionFlag.Item フラグが設定されている場合に使用される。デフォルト値はcolorScheme に依存します。

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

singleHighlightGradient : Gradient

選択オブジェクトのハイライトグラデーション。selectionModeGraphs3D.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.