このページでは

QChart Class

QChart クラスは、チャートの系列、凡例、および軸のグラフィカルな表示を管理します。詳細...

Header: #include <QChart>
Inherits: QGraphicsWidget
Inherited By:

QPolarChart

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::NoAnimation0x0チャートでアニメーションが無効になっています。これがデフォルト値です。
QChart::GridAxisAnimations0x1チャートでグリッド軸のアニメーションが有効になっています。
QChart::SeriesAnimations0x2チャートで系列のアニメーションが有効になっています。
QChart::AllAnimations0x3チャート内のすべてのアニメーションタイプが有効になっています。

AnimationOptions 型は、QFlags<AnimationOption> の typedef です。これは、AnimationOption 値の論理和(OR)の組み合わせを格納します。

enum QChart::ChartTheme

この列挙型は、チャートで使用されるテーマを表します。

テーマとは、チャートのすべての視覚的要素(シリーズの色、ペン、ブラシ、フォント、および軸、タイトル、凡例など)に適用される、UI スタイル関連の設定の組み込みコレクションです。「ウィジェット付きチャート ギャラリー」では、テーマの使用方法について解説しています。

注: テーマを変更すると 、シリーズに以前に適用されていたすべてのカスタマイズが上書きされます。

定数値説明
QChart::ChartThemeLight0ライトテーマ。デフォルトのテーマです。
QChart::ChartThemeBlueCerulean1セルリアンブルーのテーマ。
QChart::ChartThemeDark2ダークテーマ。
QChart::ChartThemeBrownSand3サンドブラウンのテーマ。
QChart::ChartThemeBlueNcs4ナチュラルカラーシステム(NCS)の青テーマ。
QChart::ChartThemeHighContrast5高コントラストテーマ。
QChart::ChartThemeBlueIcy6アイスブルーテーマ。
QChart::ChartThemeQt7Qtテーマ。

enum QChart::ChartType

この列挙型は、チャートの種類を表します。

定数値説明
QChart::ChartTypeUndefined0チャートタイプが定義されていません。
QChart::ChartTypeCartesian1デフォルト値。
QChart::ChartTypePolar2極座標グラフ。

プロパティのドキュメント

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)
QXYSeriesQValueAxisQValueAxis
QBarSeriesQBarCategoryAxisQValueAxis
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.