このページでは

GraphsView QML Type

すべてのQt Graphs ビューの基底型。詳細...

Import Statement: import QtGraphs

プロパティ

方法

詳細な説明

このクラスは、データ系列とテーマをまとめてグラフを描画します。このタイプを使用するには、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]
        }
    }
}

2023年、2024年、2025年の数値を示した棒グラフ

関連項目: 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.