QChart Class

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

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

QPolarChart

パブリック・タイプ

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

この enum は、チャートで有効なアニメーションを記述します。

定数説明
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 : const QChart::ChartType

このプロパティは、チャートが直交チャートであるか極座標チャートであるかを保持する。

このプロパティは内部的に設定され、読み取り専用である。

アクセス関数:

QChart::ChartType chartType() const

QPolarChartも参照

dropShadowEnabled : bool

このプロパティは、背景ドロップシャドウ効果が有効かどうかを保持する。

true に設定すると、背景ドロップシャドウ効果が有効になる。false に設定すると、無効になります。

注意: ドロップシャドウ効果はテーマに依存するため、テーマを変更すると設定が変更される可能性があります。

アクセス機能:

bool isDropShadowEnabled() const
void setDropShadowEnabled(bool enabled = true)

locale : QLocale

このプロパティは、様々なチャート・ラベルの書式設定に使用されるロケールを保持する。

ラベルは、localizeNumberstrue の場合のみローカライズされます。ただし、QDateTimeAxis のラベルは、常にこのプロパティで設定されたQLocale が使用されます。

デフォルトは、チャートが作成された時のアプリケーションのデフォルトロケールです。

アクセス関数:

QLocale locale() const
void setLocale(const QLocale &locale)

localizeNumbersも参照

localizeNumbers : bool

このプロパティは、数値がローカライズされるかどうかを保持する。

true の場合、さまざまな系列および軸ラベルに表示される生成されたすべての数値は、locale プロパティで設定されたQLocale を使用してローカライズされます。false の場合、Cロケールが常に使用されます。デフォルトはfalse です。

注意: このプロパティはQDateTimeAxis ラベルには影響しません。 ラベルは常に、ロケールプロパティで設定された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)

通知シグナル:

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フォーマットに対応しています。

アクセス関数

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)

alignment で指定されるように整列されたチャートに軸axis を追加する。チャートは軸の所有権を持つ。

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

orientation で指定された方向で系列series に接続された軸を返す。系列が指定されていない場合は、指定された方向でチャートに追加されたすべての軸が返されます。

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)

position で指定されたチャートのseries で指定された位置の系列の値を返す。

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)

dxdy で指定された距離だけ、チャートの可視領域をスクロールする。

極座標チャートの場合、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()、plotAreaBackgroundVisiblesetPlotAreaBackgroundBrush()、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倍にズームアウトする。

注意: 結果が無効な対数軸範囲を含む場合、これは何もしない。

void QChart::zoomReset()

シリーズのドメインを、ズーム・メソッドが呼び出される前の状態にリセットします。

注意: これは、最初のズーム操作からこのメソッドを呼び出すまでの間に指定されたスクロールと明示的な軸範囲の設定もリセットします。ズーム操作が実行されていない場合、このメソッドは何も行いません。

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