QChart Class
QChart クラスは、チャートの系列、凡例、および軸のグラフィカルな表示を管理します。詳細...
| Header: | #include <QChart> |
| Inherits: | QGraphicsWidget |
| Inherited By: | |
| Status: | Deprecated |
このクラスは非推奨です。新しいコードでの使用は強く推奨しません。
パブリック型
| enum | AnimationOption { NoAnimation, GridAxisAnimations, SeriesAnimations, AllAnimations } |
| flags | AnimationOptions |
| enum | ChartTheme { ChartThemeLight, ChartThemeBlueCerulean, ChartThemeDark, ChartThemeBrownSand, ChartThemeBlueNcs, …, ChartThemeQt } |
| enum | ChartType { ChartTypeUndefined, ChartTypeCartesian, ChartTypePolar } |
プロパティ
|
|
パブリック関数
| QChart(QGraphicsItem *parent = nullptr, Qt::WindowFlags wFlags = Qt::WindowFlags()) | |
| virtual | ~QChart() |
| void | addAxis(QAbstractAxis *axis, Qt::Alignment alignment) |
| void | addSeries(QAbstractSeries *series) |
| int | animationDuration() const |
| QEasingCurve | animationEasingCurve() const |
| QChart::AnimationOptions | animationOptions() const |
| QList<QAbstractAxis *> | axes(Qt::Orientations orientation = Qt::Horizontal|Qt::Vertical, QAbstractSeries *series = nullptr) const |
| QBrush | backgroundBrush() const |
| QPen | backgroundPen() const |
| qreal | backgroundRoundness() const |
| QChart::ChartType | chartType() const |
| void | createDefaultAxes() |
| bool | isBackgroundVisible() const |
| bool | isDropShadowEnabled() const |
| bool | isPlotAreaBackgroundVisible() const |
| bool | isZoomed() |
| QLegend * | legend() const |
| QLocale | locale() const |
| bool | localizeNumbers() const |
| QPointF | mapToPosition(const QPointF &value, QAbstractSeries *series = nullptr) |
| QPointF | mapToValue(const QPointF &position, QAbstractSeries *series = nullptr) |
| QMargins | margins() const |
| QRectF | plotArea() const |
| QBrush | plotAreaBackgroundBrush() const |
| QPen | plotAreaBackgroundPen() const |
| void | removeAllSeries() |
| void | removeAxis(QAbstractAxis *axis) |
| void | removeSeries(QAbstractSeries *series) |
| void | scroll(qreal dx, qreal dy) |
| QList<QAbstractSeries *> | series() const |
| void | setAnimationDuration(int msecs) |
| void | setAnimationEasingCurve(const QEasingCurve &curve) |
| void | setAnimationOptions(QChart::AnimationOptions options) |
| void | setBackgroundBrush(const QBrush &brush) |
| void | setBackgroundPen(const QPen &pen) |
| void | setBackgroundRoundness(qreal diameter) |
| void | setBackgroundVisible(bool visible = true) |
| void | setDropShadowEnabled(bool enabled = true) |
| void | setLocale(const QLocale &locale) |
| void | setLocalizeNumbers(bool localize) |
| void | setMargins(const QMargins &margins) |
| void | setPlotArea(const QRectF &rect) |
| void | setPlotAreaBackgroundBrush(const QBrush &brush) |
| void | setPlotAreaBackgroundPen(const QPen &pen) |
| void | setPlotAreaBackgroundVisible(bool visible = true) |
| void | setTheme(QChart::ChartTheme theme) |
| void | setTitle(const QString &title) |
| void | setTitleBrush(const QBrush &brush) |
| void | setTitleFont(const QFont &font) |
| QChart::ChartTheme | theme() const |
| QString | title() const |
| QBrush | titleBrush() const |
| QFont | titleFont() const |
| void | zoom(qreal factor) |
| void | zoomIn() |
| void | zoomIn(const QRectF &rect) |
| void | zoomOut() |
| void | zoomReset() |
シグナル
| void | plotAreaChanged(const QRectF &plotArea) |
詳細説明
QChartは、QGraphicsScene 内で表示できるQGraphicsWidget です。これは、さまざまな種類の系列や、凡例や軸といったその他のチャート関連オブジェクトのグラフィカルな表現を管理します。 レイアウト内にチャートを簡単に表示するには、QChartの代わりに利便性クラスQChartView を使用できます。さらに、QPolarChart クラスを使用することで、線、スプライン、面、散布図の各シリーズを極座標チャートとして表示することができます。
QChartView およびQPolarChartも参照してください 。
メンバ型のドキュメント
enum QChart::AnimationOption
flags QChart::AnimationOptions
この列挙型は、チャートで有効になっているアニメーションを表します。
| 定数 | 値 | 説明 |
|---|---|---|
QChart::NoAnimation | 0x0 | チャートでアニメーションが無効になっています。これがデフォルト値です。 |
QChart::GridAxisAnimations | 0x1 | チャートでグリッド軸のアニメーションが有効になっています。 |
QChart::SeriesAnimations | 0x2 | チャートで系列のアニメーションが有効になっています。 |
QChart::AllAnimations | 0x3 | チャート内のすべてのアニメーションタイプが有効になっています。 |
AnimationOptions 型は、QFlags<AnimationOption> の typedef です。これは、AnimationOption 値の論理和(OR)の組み合わせを格納します。
enum QChart::ChartTheme
この列挙型は、チャートで使用されるテーマを表します。
テーマとは、チャートのすべての視覚的要素(シリーズの色、ペン、ブラシ、フォント、および軸、タイトル、凡例など)に適用される、UI スタイル関連の設定の組み込みコレクションです。「ウィジェット付きチャート ギャラリー」では、テーマの使用方法について解説しています。
注: テーマを変更すると 、シリーズに以前に適用されていたすべてのカスタマイズが上書きされます。
| 定数 | 値 | 説明 |
|---|---|---|
QChart::ChartThemeLight | 0 | ライトテーマ。デフォルトのテーマです。 |
QChart::ChartThemeBlueCerulean | 1 | セルリアンブルーのテーマ。 |
QChart::ChartThemeDark | 2 | ダークテーマ。 |
QChart::ChartThemeBrownSand | 3 | サンドブラウンのテーマ。 |
QChart::ChartThemeBlueNcs | 4 | ナチュラルカラーシステム(NCS)の青テーマ。 |
QChart::ChartThemeHighContrast | 5 | 高コントラストテーマ。 |
QChart::ChartThemeBlueIcy | 6 | アイスブルーテーマ。 |
QChart::ChartThemeQt | 7 | Qtテーマ。 |
enum QChart::ChartType
この列挙型は、チャートの種類を表します。
| 定数 | 値 | 説明 |
|---|---|---|
QChart::ChartTypeUndefined | 0 | チャートタイプが定義されていません。 |
QChart::ChartTypeCartesian | 1 | デフォルト値。 |
QChart::ChartTypePolar | 2 | 極座標グラフ。 |
プロパティのドキュメント
animationDuration : int
このプロパティは、チャートのアニメーションの継続時間を指定します。
アクセス関数:
| int | animationDuration() const |
| void | setAnimationDuration(int msecs) |
animationEasingCurve : QEasingCurve
このプロパティは、チャートのアニメーションのイージングカーブを保持します。
アクセス関数:
| QEasingCurve | animationEasingCurve() const |
| void | setAnimationEasingCurve(const QEasingCurve &curve) |
animationOptions : QChart::AnimationOptions
このプロパティには、チャートのアニメーション設定が格納されています。
この設定に基づいて、アニメーションの有効/無効が決定されます。
アクセス関数:
| QChart::AnimationOptions | animationOptions() const |
| void | setAnimationOptions(QChart::AnimationOptions options) |
backgroundRoundness : qreal
このプロパティは、チャートの背景の角にある丸み付け円の直径を指定します。
アクセス関数:
| qreal | backgroundRoundness() const |
| void | setBackgroundRoundness(qreal diameter) |
backgroundVisible : bool
このプロパティは、チャートの背景が表示されるかどうかを指定します。
アクセス関数:
| bool | isBackgroundVisible() const |
| void | setBackgroundVisible(bool visible = true) |
関連項目: setBackgroundBrush()、setBackgroundPen()、およびplotAreaBackgroundVisible 。
[read-only] chartType : QChart::ChartType
このプロパティは、チャートが直交座標系チャートであるか極座標系チャートであるかに関係なく有効です。
このプロパティは内部的に設定され、読み取り専用です。
アクセス関数:
| QChart::ChartType | chartType() const |
「QPolarChart」も参照してください 。
dropShadowEnabled : bool
このプロパティは、背景のドロップシャドウ効果が有効かどうかを指定します。
true に設定すると、背景のドロップシャドウ効果が有効になります。false に設定すると、無効になります。
注:ドロップシャドウ効果はテーマに 依存するため、テーマを変更すると設定が変更される場合があります。
アクセス関数:
| bool | isDropShadowEnabled() const |
| void | setDropShadowEnabled(bool enabled = true) |
locale : QLocale
このプロパティには、各種チャートのラベルの書式設定に使用されるロケールが格納されます。
ラベルは、localizeNumbers がtrue の場合にのみローカライズされます。ただし、QDateTimeAxisのラベルは例外であり、常にこのプロパティで設定されたQLocale が使用されます。
デフォルトは、チャートが構築された時点でのアプリケーションのデフォルトロケールです。
アクセス関数:
| QLocale | locale() const |
| void | setLocale(const QLocale &locale) |
「localizeNumbers」も参照してください 。
localizeNumbers : bool
このプロパティは、数値がローカライズされているかどうかにかかわらず有効です。
true の場合、各種系列や軸ラベルに表示されるすべての生成された数値は、locale プロパティで設定されたQLocale を使用してローカライズされます。false の場合、常にCロケールが使用されます。デフォルトはfalse です。
注:この プロパティはQDateTimeAxisのラベルには影響しません。QDateTimeAxisのラベルでは、常にlocaleプロパティで設定されたQLocale が使用されます。
アクセス関数:
| bool | localizeNumbers() const |
| void | setLocalizeNumbers(bool localize) |
「locale」も参照してください 。
margins : QMargins
このプロパティは、チャートの矩形の端とプロット領域との間に許容される最小の余白を指定します。
これらの余白は、タイトル、軸、および凡例の描画に使用されます。
アクセス関数:
| QMargins | margins() const |
| void | setMargins(const QMargins &margins) |
plotArea : QRectF
このプロパティは、チャートが描画される矩形を保持します。
プロット領域には、マージンで定義された領域は含まれません。デフォルトでは、QChartView 内に配置された場合、この領域は自動的にサイズ変更されます。プロット領域に明示的なサイズが設定されている場合は、そのサイズが優先されます。デフォルトの挙動に戻すには、setPlotArea(QRectF()); を呼び出してください。
アクセス関数:
| QRectF | plotArea() const |
| void | setPlotArea(const QRectF &rect) |
Notifierシグナル:
| void | plotAreaChanged(const QRectF &plotArea) |
plotAreaBackgroundVisible : bool
このプロパティは、チャートのプロット領域の背景が表示されるかどうかを指定します。
注:デフォルトでは 、プロット領域の背景は非表示になっており、プロット領域はチャートの一般的な背景を使用します。
アクセス関数:
| bool | isPlotAreaBackgroundVisible() const |
| void | setPlotAreaBackgroundVisible(bool visible = true) |
関連項目: setPlotAreaBackgroundBrush()、setPlotAreaBackgroundPen()、およびbackgroundVisible 。
theme : QChart::ChartTheme
このプロパティは、チャートに使用されるテーマを保持します。
アクセス関数:
| QChart::ChartTheme | theme() const |
| void | setTheme(QChart::ChartTheme theme) |
title : QString
このプロパティは、チャートのタイトルを保持します。
タイトルは、グラフの上部に見出しとして表示されます。グラフのタイトルでは、HTML 形式での書式設定が可能です。
Access 関数:
| QString | title() const |
| void | setTitle(const QString &title) |
メンバー関数のドキュメント
[explicit] QChart::QChart(QGraphicsItem *parent = nullptr, Qt::WindowFlags wFlags = Qt::WindowFlags())
parent の子となるチャートオブジェクトを作成します。wFlags で指定されたプロパティは、QGraphicsWidget のコンストラクタに渡されます。
[virtual noexcept] QChart::~QChart()
チャートオブジェクトと、それに追加された系列や軸などの子オブジェクトを削除します。
void QChart::addAxis(QAbstractAxis *axis, Qt::Alignment alignment)
軸「axis 」を、alignment で指定された配置に従ってチャートに追加します。チャートがこの軸の所有権を取得します。
removeAxis()、createDefaultAxes()、およびQAbstractSeries::attachAxis()も参照してください 。
void QChart::addSeries(QAbstractSeries *series)
series というシリーズをチャートに追加し、その所有権を取得します。
注: 新しく追加された系列は 、デフォルトではどの軸にも関連付けられていません。これは、その系列がチャートに追加される前に `createDefaultAxes()` を使用してチャート用に作成された軸であっても同様です。 チャートが表示される前に、新しく追加された系列に軸が割り当てられていない場合、その系列は、チャートのプロット領域にぴったりと収まる範囲を持つ軸が割り当てられているかのように描画されます。 同じチャートに、軸が適切に割り当てられた他の系列も表示されている場合、これは混乱を招く恐れがあるため、系列を追加した後に必ず `createDefaultAxes()` を呼び出すか、その系列に明示的に軸を割り当てるようにしてください。
関連項目: removeSeries()、removeAllSeries()、createDefaultAxes()、QAbstractSeries::attachAxis()。
QList<QAbstractAxis *> QChart::axes(Qt::Orientations orientation = Qt::Horizontal|Qt::Vertical, QAbstractSeries *series = nullptr) const
series に紐付けられた軸を、orientation で指定された向きで返します。シリーズが指定されていない場合は、指定された向きでチャートに追加されたすべての軸が返されます。
addAxis() およびcreateDefaultAxes()も参照してください 。
QBrush QChart::backgroundBrush() const
チャート領域の背景の描画に使用されるブラシを取得します。
setBackgroundBrush()も参照してください 。
QPen QChart::backgroundPen() const
チャート領域の背景の描画に使用されるペンを取得します。
setBackgroundPen()も参照してください 。
void QChart::createDefaultAxes()
チャートにすでに追加されている系列に基づいて、チャートの軸を作成します。以前にチャートに追加されていた軸はすべて削除されます。
注:この関数は 、すべての系列がチャートに追加された後に呼び出す必要があります。この関数によって作成された軸は、この関数の呼び出し後にチャートに追加された系列には自動的に紐付けられません。 軸が割り当てられていない系列は、デフォルトでチャートのプロット領域全体を利用するように拡大縮小されます。これにより、適切に軸が割り当てられた他の系列も存在する場合、見づらくなる可能性があります。
| 系列の種類 | 横軸 (X) | 縦軸 (Y) |
|---|---|---|
| QXYSeries | QValueAxis | QValueAxis |
| QBarSeries | QBarCategoryAxis | QValueAxis |
| QPieSeries | なし | なし |
チャートに QXYSeries を基にしたシリーズが複数追加されており、他のタイプのシリーズが追加されていない場合、軸のペアは 1 組のみ作成されます。異なるタイプのシリーズが複数チャートに追加されている場合、各シリーズには独自の軸のペアが割り当てられます。
各系列に固有の軸は、後でaxes()関数の呼び出しにおいて、その系列をパラメータとして指定することで、チャートから取得できます。QPieSeriesは軸を作成しません。
axes() およびQAbstractSeries::attachAxis()も参照してください 。
bool QChart::isZoomed()
いずれかの系列にズームされた領域が含まれている場合、true を返します。
QLegend *QChart::legend() const
チャートの凡例オブジェクトを返します。所有権はチャートのままです。
QPointF QChart::mapToPosition(const QPointF &value, QAbstractSeries *series = nullptr)
series で指定された系列において、値value に対応するチャート上の位置を返します。
QPointF QChart::mapToValue(const QPointF &position, QAbstractSeries *series = nullptr)
チャートにおいて、series で指定された系列のうち、position で指定された位置にある値を返します。
QBrush QChart::plotAreaBackgroundBrush() const
チャートのプロット領域の背景を塗りつぶすために使用されたブラシを返します。
関連項目: plotArea()、plotAreaBackgroundVisible 、plotAreaBackgroundPen()、およびsetPlotAreaBackgroundBrush()。
QPen QChart::plotAreaBackgroundPen() const
チャートのプロット領域の背景を描画するために使用されたペンを返します。
plotArea()、plotAreaBackgroundVisible 、plotAreaBackgroundBrush()、およびsetPlotAreaBackgroundPen()も参照してください 。
void QChart::removeAllSeries()
チャートに追加されたすべてのシリーズオブジェクトを取り除き、削除します。
addSeries() およびremoveSeries()も参照してください 。
void QChart::removeAxis(QAbstractAxis *axis)
チャートから軸「axis 」を削除します。チャートは、指定されたaxis オブジェクトの所有権を解放します。
addAxis()、createDefaultAxes()、およびQAbstractSeries::detachAxis()も参照してください 。
void QChart::removeSeries(QAbstractSeries *series)
チャートからシリーズ「series 」を削除します。チャートは、指定されたseries オブジェクトの所有権を解放します。
addSeries() およびremoveAllSeries()も参照してください 。
void QChart::scroll(qreal dx, qreal dy)
dx およびdy で指定された距離分だけ、チャートの表示領域をスクロールします。
極座標チャートの場合、dx は距離ではなく、角度軸に沿った角度を示します。
QList<QAbstractSeries *> QChart::series() const
チャートに追加されているすべてのシリーズを返します。
addSeries()、removeSeries()、およびremoveAllSeries()も参照してください 。
void QChart::setBackgroundBrush(const QBrush &brush)
チャート領域の背景の描画に使用するブラシを「brush 」に設定します。
backgroundBrush()も参照してください 。
void QChart::setBackgroundPen(const QPen &pen)
チャート領域の背景の描画に使用するペンをpen に設定します。
backgroundPen()も参照してください 。
void QChart::setPlotAreaBackgroundBrush(const QBrush &brush)
チャートのプロット領域の背景を塗りつぶす際に使用するブラシを「brush 」に設定します。
plotArea()、plotAreaBackgroundVisible 、setPlotAreaBackgroundPen()、およびplotAreaBackgroundBrush()も参照してください 。
void QChart::setPlotAreaBackgroundPen(const QPen &pen)
チャートのプロット領域の背景を描画するために使用されるペンを、pen に設定します。
plotArea()、plotAreaBackgroundVisible 、setPlotAreaBackgroundBrush()、およびplotAreaBackgroundPen()も参照してください 。
void QChart::setTitleBrush(const QBrush &brush)
タイトルテキストの描画に使用するブラシを「brush 」に設定します。
titleBrush()も参照してください 。
void QChart::setTitleFont(const QFont &font)
チャートのタイトルを描画する際に使用するフォントを「font 」に設定します。
titleFont()も参照してください 。
QBrush QChart::titleBrush() const
タイトルテキストの描画に使用されたブラシを返します。
setTitleBrush()も参照してください 。
QFont QChart::titleFont() const
チャートのタイトルを描画するために使用されるフォントを取得します。
setTitleFont()も参照してください 。
void QChart::zoom(qreal factor)
factor というカスタム倍率でビューを拡大します。
倍率が 1.0 を超えるとビューが拡大され、0.0 から 1.0 の間の倍率ではビューが縮小されます。
void QChart::zoomIn()
表示を2倍に拡大します。
void QChart::zoomIn(const QRectF &rect)
矩形rect が完全に表示されたままになる最大レベルまで、ビューを拡大します。
注: ズームを適用すると 、関連付けられた軸のプロパティ(例:QAbstractAxis::min や QAbstractAxis::max)が変更される場合があります。
注:これは 極座標グラフではサポートされていません。
void QChart::zoomOut()
ビューを2分の1の倍率で縮小します。
注: その結果として無効な対数軸の範囲が含まれることになる場合、この操作は 何も行われません。
void QChart::zoomReset()
シリーズのドメインを、ズームメソッドが呼び出される前の状態に戻します。
注:これにより 、最初のズーム操作からこのメソッドの呼び出しまでの間に指定されたスクロール設定や明示的な軸範囲設定もリセットされます。ズーム操作が実行されていない場合、このメソッドは何もしません。
© 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.