Qt Charts

Qt Charts モジュールは、使いやすいチャートコンポーネントのセットを提供します。Qt Graphics View Framework を使用して、チャートを最新のユーザーインターフェースに統合します。Qt Charts は、QWidgets、QGraphicsWidget 、または QML タイプとして使用できます。テーマを選択することで、印象的なチャートを簡単に作成することができます。

注意: Qt Charts モジュールは Qt 6.10 から非推奨になりました。新しいプロジェクトでは、代わりに Qt GraphsQt Graphs Qt Graphs は、各プラットフォームのネイティブレンダリングバックエンド(macOS では Metal、Windows では DirectX、Linux では OpenGL または Vulkan)を使用して、2D と 3D グラフの両方でハードウェアアクセラレーションによるレンダリングを実現します。 Qt Quick Shapes2D グラフ レンダリングには、Qt Charts モジュールで使用されていた時代遅れの Qt Graphics View Framework を使用しません。Qt Charts からQt Graphs モジュールへの移行は、Qt Graphs Qt Charts からの移行を参照してください。

Qt Charts QML APIは、QMLアプリケーションでグラフを表示する直感的でシンプルな方法です。

この例では、簡単な折れ線グラフの作成方法を示します:

ChartView {
    title: "Line Chart"
    anchors.fill: parent
    antialiasing: true

    LineSeries {
        name: "Line"
        XYPoint { x: 0; y: 0 }
        XYPoint { x: 1.1; y: 2.1 }
        XYPoint { x: 1.9; y: 3.3 }
        XYPoint { x: 2.1; y: 2.1 }
        XYPoint { x: 2.9; y: 4.9 }
        XYPoint { x: 3.4; y: 3.0 }
        XYPoint { x: 4.1; y: 3.3 }
    }
}

モジュールを使う

QML API

モジュールの QML 型はQtCharts のインポートから利用できます。この型を使うには、.qml ファイルに以下の import 文を追加してください:

import QtCharts

注: モジュールはレンダリングに Qt のGraphics View Frameworkに依存しているため、QML タイプにはQApplication のインスタンスが必要です。QGuiApplication では不十分です。ただし、Qt CreatorQt Quick アプリケーションウィザードで作成されたプロジェクトは、デフォルトでQGuiApplication を使用するQt Quick テンプレートに基づいています。このようなプロジェクトのQGuiApplication インスタンスは、すべてQApplication に置き換える必要があります。

C++ API

Qt モジュールの C++ API を使用するには、モジュール・ライブラリを直接リンクするか、他の依存関係を通 してリンクする必要があります。CMakeや qmakeなど、いくつかのビルドツールはこのための専用サポートを持っています。

CMake でのビルド

find_package() コマンドを使用して、必要なモジュール・コンポーネントをQt6 パッケージから探します:

find_package(Qt6 REQUIRED COMPONENTS Charts)
target_link_libraries(mytarget PRIVATE Qt6::Charts)

詳細については、CMakeによるビルドの概要を参照してください。

qmakeでのビルド

モジュールをqmakeでビルドするように設定するには、プロジェクトの.proファイルにQT 変数の値としてモジュールを追加します:

QT += charts

モジュールの進化

Qt Charts の変更点には、Qt 6 シリーズの Qt のために行われたモジュール API と機能の重要な変更が記載されています。

記事とガイド

API リファレンス

ライセンス

Qt Charts は、The Qt Companyの商用ライセンスの下で利用可能です。また、GNU General Public License, version 3 の下でも利用可能です。詳細はQt Licensingを参照してください。

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