GraphsView QML Type
すべてのQt Graphs ビューの基底型。詳細...
| Import Statement: | import QtGraphs |
- 継承されたメンバーを含む、すべてのメンバーの一覧
- GraphsViewは、Qt Graphs の2D用QMLタイプの一部です。
プロパティ
- axisX : AbstractAxis
- axisXSmoothing : real
- axisY : AbstractAxis
- axisYSmoothing : real
- clipPlotArea : bool
(since 6.10) - dynamicLabelMargins : bool
- gridSmoothing : real
- marginBottom : real
- marginLeft : real
- marginRight : real
- marginTop : real
- orientation : Qt.Orientation
- panStyle : enumeration
(since 6.9) - plotArea : rect
(since 6.9) - seriesList : list
- shadowBarWidth : real
- shadowColor : color
- shadowSmoothing : real
- shadowVisible : bool
- shadowXOffset : real
- shadowYOffset : real
- theme : GraphsTheme
- zoomAreaDelegate : Component
(since 6.9) - zoomAreaEnabled : bool
(since 6.9) - zoomSensitivity : real
(since 6.9) - zoomStyle : enumeration
(since 6.9)
方法
- void addSeries(AbstractSeries series)
- bool hasSeries(AbstractSeries series)
- void insertSeries(int index, AbstractSeries series)
- void removeSeries(AbstractSeries series)
- void removeSeries(int index)
詳細な説明
このクラスは、データ系列とテーマをまとめてグラフを描画します。このタイプを使用するには、Qt Graphs モジュールをインポートする必要があります:
import QtGraphsその後、qmlファイル内でGraphsViewを使用できるようになります:
import QtQuick
import QtGraphs
GraphsView {
anchors.fill: parent
theme: GraphsTheme {
colorScheme: GraphsTheme.ColorScheme.Dark
seriesColors: ["#E0D080", "#B0A060"]
borderColors: ["#807040", "#706030"]
grid.mainColor: "#ccccff"
grid.subColor: "#eeeeff"
axisY.mainColor: "#ccccff"
axisY.subColor: "#eeeeff"
}
axisX: BarCategoryAxis {
categories: ["2023", "2024", "2025"]
lineVisible: false
}
axisY: ValueAxis {
min: 0
max: 10
subTickCount: 4
}
BarSeries {
BarSet {
values: [7, 6, 9]
}
BarSet {
values: [9, 8, 6]
}
}
}
関連項目: BarSeries 、LineSeries 、BarCategoryAxis 、ValueAxis 、およびGraphsTheme 。
プロパティのドキュメント
axisX : AbstractAxis
このビュー内の系列に使用されるX軸。
注: 同じ軸を複数のGraphsViewに設定することは サポートされていません。
axisYも参照してください 。
axisXSmoothing : real
グラフのX軸の平滑化(アンチエイリアシング)の程度を制御します。デフォルトでは、平滑化は1.0 に設定されています。
axisY : AbstractAxis
このビュー内の系列に使用されるy軸。
注: 同じ軸を複数のGraphsViewに設定することは サポートされていません。
axisXも参照してください 。
axisYSmoothing : real
グラフのY軸の平滑化(アンチエイリアシング)の程度を制御します。デフォルトでは、平滑化は1.0 に設定されています。
clipPlotArea : bool [since 6.10]
グラフ項目がプロット領域の外側にはみ出した場合に、その項目をクリップするかどうかを指定します。デフォルト値はtrue です。
このプロパティは Qt 6.10 で導入されました。
「plotArea」も参照してください 。
dynamicLabelMargins : bool
このプロパティは、ラベルの余白が動的に調整されるかどうかを指定します。
デフォルトでは、割り当てられた余白よりも幅の広いラベルは、他のグラフ要素と重なってしまいます。このプロパティを有効にすると、レンダラーはそうしたラベルのために余分なスペースを確保し、重なりを防ぐために軸の位置を調整します。
gridSmoothing : real
グラフのグリッドのスムージング(アンチエイリアシング)の程度を制御します。デフォルトでは、スムージングの値は1.0 です。
marginBottom : real
グラフの下部に表示される余白の量。デフォルトでは、余白は20です。
marginLeft : real
グラフの左側にある余白の量です。デフォルトでは、余白は 20 です。
marginRight : real
グラフの右側の余白の量。デフォルトでは、マージンは20です。
marginTop : real
グラフの上部にある余白の量。デフォルトでは、余白は20です。
orientation : Qt.Orientation
GraphsView の向きを指定します。向きが「Qt.Horizontal 」の場合、「axisX 」および「axisY 」の位置が入れ替わり、「axisX 」が縦向きに、「axisY 」が横向きにレンダリングされます。このプロパティは現在、BarSeries によって使用されています。デフォルト値はQt.Vertical です。
panStyle : enumeration [since 6.9]
GraphsView のパン方式を指定します。パン操作は、ValueAxis のpanプロパティを操作することで行われます。デフォルト値はGraphsView.PanStyle.None です。
| 定数 | 説明 |
|---|---|
GraphsView.PanStyle.None | パン機能は無効です。 |
GraphsView.PanStyle.Drag | マウスやタッチ操作によるドラッグでビューをパンします。 |
このプロパティは Qt 6.9 で導入されました。
plotArea : rect [read-only, since 6.9]
グラフが描画される矩形。これは、GraphsView 領域から軸領域と余白を差し引いたものです。
このプロパティは Qt 6.9 で導入されました。
関連項目: marginTop 、marginBottom 、marginLeft 、およびmarginRight 。
seriesList : list [read-only]
GraphsView によってレンダリングされるシリーズのリストです。GraphsView の子要素であるシリーズタイプが自動的に入力されます。
これはデフォルトのプロパティであるため、子要素は自動的にシリーズリストに追加されます。
BarSeries 、LineSeries 、およびScatterSeriesも参照してください 。
shadowBarWidth : real
グラフグリッドの影の幅を制御します。デフォルトでは、影の幅は2.0 に設定されています。
shadowColor : color
グラフのグリッドの影の色を指定します。デフォルトでは、影の色はblack に設定されています。
shadowSmoothing : real
グラフグリッドのシャドウスムージング(アンチエイリアシング)の程度を制御します。デフォルトでは、シャドウスムージングは4.0 に設定されています。
shadowVisible : bool
グラフのグリッドの影を表示するかどうかを制御します。デフォルトでは、影の表示設定は「false 」に設定されています。
shadowXOffset : real
グラフグリッドの影のX方向のオフセットを制御します。デフォルトでは、影のX方向のオフセットは0.0 に設定されています。
shadowYOffset : real
グラフグリッドの影のY軸オフセットを制御します。デフォルトでは、影のY軸オフセットは0.0 に設定されています。
theme : GraphsTheme
グラフで使用されるテーマ。色、軸線、フォントなどを決定します。テーマが設定されていない場合は、デフォルトのテーマが使用されます。
zoomAreaDelegate : Component [since 6.9]
ユーザーがドラッグ操作を行って特定の領域を拡大表示する際に、描画されるQML要素を指定します。
このプロパティは Qt 6.9 で導入されました。
zoomAreaEnabled : bool [since 6.9]
ズーム領域では、マウスやタッチ操作によるドラッグで、zoomAreaDelegate で定義されたボックスが描画されます。ドラッグを解除すると、ValueAxis のズームおよびパンプロパティが変更され、描画されたボックスと交差する領域のみがビューに表示されるようになります。
このプロパティは Qt 6.9 で導入されました。
zoomAreaDelegateも参照してください 。
zoomSensitivity : real [since 6.9]
ズーム中にズーム値が変化する速度を決定します。
このプロパティはQt 6.9で導入されました。
zoomStyle : enumeration [since 6.9]
GraphsView のズームスタイルを指定します。ズームは、ValueAxis のzoomプロパティを操作することで機能します。デフォルト値はGraphsView.ZoomStyle.None です。
| 定数 | 説明 |
|---|---|
GraphsView.ZoomStyle.None | ズームは無効になります。 |
GraphsView.ZoomStyle.Center | ピンチズームおよびマウスホイールによるズームは、グラフビューの中心に向かって行われます。 |
このプロパティは Qt 6.9 で導入されました。
メソッドのドキュメント
void addSeries(AbstractSeries series)
series をGraphsView に追加します。series がnullの場合、追加されません。series がすでにグラフに存在する場合、その要素は末尾に移動されます。
bool hasSeries(AbstractSeries series)
series がグラフに含まれている場合、true を返します。
void insertSeries(int index, AbstractSeries series)
index で指定された位置に、series を挿入します。series がnullの場合、挿入は行われません。series がすでにグラフに存在する場合、index に移動されます。
void removeSeries(AbstractSeries series)
グラフからseries を削除します。
void removeSeries(int index)
index で指定された系列をグラフから削除します。
© 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.