GraphsTheme QML Type
グラフの視覚的スタイル。詳細...
| Import Statement: | import QtGraphs |
| In C++: | QGraphsTheme |
- 継承されたメンバーを含む、すべてのメンバーの一覧
- GraphsThemeは、Qt Graphs のQML共通型の一部です。
プロパティ
- GraphsLine.labelTextColor : color
- GraphsLine.mainColor : color
- GraphsLine.mainWidth : real
- GraphsLine.subColor : color
- GraphsLine.subWidth : real
- axisX : GraphsLine
- axisXLabelFont : font
- axisY : GraphsLine
- axisYLabelFont : font
- axisZ : GraphsLine
- axisZLabelFont : font
- backgroundColor : color
- backgroundVisible : bool
- baseColors : list<Color>
- baseGradients : list<Gradient>
- borderColors : list<color>
- colorScheme : QGraphsTheme::ColorScheme
- colorStyle : GraphsTheme.ColorStyle
- grid : GraphsLine
- gridVisible : bool
- labelBackgroundColor : color
- labelBackgroundVisible : bool
- labelBorderVisible : bool
- labelFont : font
- labelTextColor : color
- labelsVisible : bool
- multiHighlightColor : color
- multiHighlightGradient : Gradient
- plotAreaBackgroundColor : color
- plotAreaBackgroundVisible : bool
- seriesColors : list<color>
- singleHighlightColor : color
- singleHighlightGradient : Gradient
- theme : GraphsTheme.Theme
詳細説明
このタイプは、グラフ全体に影響を与える視覚的なプロパティを指定するために使用されます。そのまま使用することも、自由に変更することもできる組み込みのテーマがいくつか用意されています。
GraphsTheme.Theme.UserDefined 列挙型の値を使用することで、テーマをゼロから作成することもできます。
テーマのカスタマイズ
デフォルトのテーマは QtGreen ですが、各プロパティをカスタマイズすることができます。
次の表は、テーマによって制御されるプロパティと、QGraphsTheme.Theme.UserDefined のデフォルト値の一覧です。
| プロパティ | デフォルト値 |
|---|---|
| backgroundVisible | true |
| seriesColors | Qt::black |
| baseGradients | QLinearGradient。実質的に完全な黒です。 |
| colorStyle | Uniform |
| labelFont | QFont |
| gridVisible | true |
| labelBackgroundVisible | true |
| labelBorderVisible | true |
| labelsVisible | true |
使用例
変更を加えずに組み込みテーマを使用する場合:
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.