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()、plotAreaBackgroundVisibleplotAreaBackgroundPen()、setPlotAreaBackgroundBrush()も参照

QPen QChart::plotAreaBackgroundPen() const

ペン:チャートのプロット領域の背景を描画するために使用されたペンを返します。

plotArea()、plotAreaBackgroundVisibleplotAreaBackgroundBrush()、およびsetPlotAreaBackgroundPen() も参照して ください。

void QChart::removeAllSeries()

series()] チャートに追加されたすべての系列オブジェクトを削除します。

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()、plotAreaBackgroundVisiblesetPlotAreaBackgroundPen()、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()

ズーム・メソッドを呼び出す前の状態にリセットします。

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

©2024 The Qt Company Ltd. 本文書に含まれる文書の著作権は、それぞれの所有者に帰属します。 本書で提供されるドキュメントは、Free Software Foundation が発行したGNU Free Documentation License version 1.3に基づいてライセンスされています。 Qtおよびそれぞれのロゴは、フィンランドおよびその他の国におけるThe Qt Company Ltd.の 商標です。その他すべての商標は、それぞれの所有者に帰属します。