QChart Class
QChart クラスは、チャートの系列、凡例、軸のグラフィカル表現を管理します。詳細...
Header: | #include <QChart> |
Inherits: | QGraphicsWidget |
Inherited By: |
パブリック・タイプ
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::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 : const 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 ラベルには影響しません。 ラベルは常に、ロケールプロパティで設定された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) |
---|---|---|
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)
position で指定された位置のseries で指定されたシリーズの値をチャート上で返します。
QBrush QChart::plotAreaBackgroundBrush() const
ブラシ: チャートのプロット領域の背景を塗りつぶすために使用されるブラシを返します。
plotArea()、plotAreaBackgroundVisible 、plotAreaBackgroundPen()、setPlotAreaBackgroundBrush()も参照 。
QPen QChart::plotAreaBackgroundPen() const
ペン:チャートのプロット領域の背景を描画するために使用されたペンを返します。
plotArea()、plotAreaBackgroundVisible 、plotAreaBackgroundBrush()、および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()、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 倍にズームアウトします。
注意 : 結果に無効な対数軸範囲が含まれる場合、これは何もしません。
void QChart::zoomReset()
ズーム・メソッドを呼び出す前の状態にリセットします。
注意: これは、最初のズーム操作からこのメソッドを呼び出すまでの間に指定されたスクロールと明示的な軸範囲の設定もリセットします。ズーム操作が実行されていない場合、このメソッドは何もしません。
©2024 The Qt Company Ltd. 本文書に含まれる文書の著作権は、それぞれの所有者に帰属します。 本書で提供されるドキュメントは、Free Software Foundation が発行したGNU Free Documentation License version 1.3に基づいてライセンスされています。 Qtおよびそれぞれのロゴは、フィンランドおよびその他の国におけるThe Qt Company Ltd.の 商標です。その他すべての商標は、それぞれの所有者に帰属します。