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()
チャートに追加されたすべての系列オブジェクトを削除します。
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()
シリーズのドメインを、ズーム・メソッドが呼び出される前の状態にリセットします。
注意: これは、最初のズーム操作からこのメソッドを呼び出すまでの間に指定されたスクロールと明示的な軸範囲の設定もリセットします。ズーム操作が実行されていない場合、このメソッドは何も行いません。
© 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.