QAbstractSeries Class

QAbstractSeries クラスは、すべての Qt Chart シリーズの基本クラスです。詳細...

Header: #include <QAbstractSeries>
In QML: AbstractSeries
Inherits: QObject
Inherited By:

QAbstractBarSeries, QAreaSeries, QBoxPlotSeries, QCandlestickSeries, QPieSeries, and QXYSeries

パブリックタイプ

enum SeriesType { SeriesTypeLine, SeriesTypeArea, SeriesTypeBar, SeriesTypeStackedBar, SeriesTypePercentBar, …, SeriesTypeCandlestick }

プロパティ

パブリック関数

virtual ~QAbstractSeries()
bool attachAxis(QAbstractAxis *axis)
QList<QAbstractAxis *> attachedAxes()
QChart *chart() const
bool detachAxis(QAbstractAxis *axis)
void hide()
bool isVisible() const
QString name() const
qreal opacity() const
void setName(const QString &name)
void setOpacity(qreal opacity)
void setUseOpenGL(bool enable = true)
void setVisible(bool visible = true)
void show()
virtual QAbstractSeries::SeriesType type() const = 0
bool useOpenGL() const

シグナル

詳細説明

通常、基底クラスの代わりに、シリーズ型固有の継承クラスが使用される。

QXYSeries,QLineSeries,QSplineSeries,QScatterSeries,QAreaSeries,QAbstractBarSeries,QBarSeries,QStackedBarSeries,QPercentBarSeries,QHorizontalBarSeries,QHorizontalStackedBarSeries,QHorizontalPercentBarSeries,QPieSeriesも参照のこと

メンバ型ドキュメント

enum QAbstractSeries::SeriesType

この列挙型は系列の型を記述する。

定数説明
QAbstractSeries::SeriesTypeLine0折れ線グラフ
QAbstractSeries::SeriesTypeArea1エリアチャート
QAbstractSeries::SeriesTypeBar2垂直棒グラフ
QAbstractSeries::SeriesTypeStackedBar3垂直積み上げ棒グラフ
QAbstractSeries::SeriesTypePercentBar4垂直パーセント棒グラフ
QAbstractSeries::SeriesTypePie5円グラフ
QAbstractSeries::SeriesTypeScatter6散布図
QAbstractSeries::SeriesTypeSpline7スプラインチャート
QAbstractSeries::SeriesTypeHorizontalBar8水平棒グラフ
QAbstractSeries::SeriesTypeHorizontalStackedBar9水平積み上げ棒グラフ
QAbstractSeries::SeriesTypeHorizontalPercentBar10水平パーセント棒グラフ
QAbstractSeries::SeriesTypeBoxPlot11ボックス・プロット・チャート
QAbstractSeries::SeriesTypeCandlestick12ローソク足チャート

プロパティの説明

name : QString

このプロパティは系列の名前を保持する。

この名前は系列の凡例に表示され、HTML書式をサポートする。

アクセス関数

QString name() const
void setName(const QString &name)

通知シグナル:

void nameChanged()

opacity : qreal

このプロパティは系列の不透明度を保持する。

デフォルトでは、不透明度は1.0である。有効な値の範囲は0.0(透明)から1.0(不透明)です。

アクセス関数:

qreal opacity() const
void setOpacity(qreal opacity)

通知シグナル:

[read-only] type : const SeriesType

このプロパティは系列のタイプを保持する。

アクセス関数:

virtual QAbstractSeries::SeriesType type() const = 0

useOpenGL : bool

アクセス関数:系列の描画を OpenGL を用いて高速化するか否かを指定する。

OpenGL による高速化はQLineSeriesQScatterSeries でのみサポートされる。QAreaSeries のエッジ系列として使用される線系列は、OpenGL アクセラレーションを使用できない。チャートに OpenGL で描画される系列が含まれる場合、チャートのプロット領域の上に透明な QOpenGLWidget が作成されます。アクセラレーションされた系列は、その下にあるQGraphicsView には描画されず、作成された QOpenGLWidget に描画されます。

OpenGLを使用して系列描画を高速化することで得られるパフォーマンスは、基盤となるハードウェアに依存しますが、ほとんどの場合、それは重要です。たとえば、標準的なデスクトップ・コンピュータでは、系列に対してOpenGLアクセラレーションを有効にすると、通常、フレーム・レートを低下させることなく、少なくとも100倍多くのポイントをレンダリングできます。チャートのサイズもフレームレートにあまり影響しません。

直列描画のOpenGLアクセラレーションは、大量のポイントを高速に描画する必要があるユースケースを想定しています。これは効率化のために最適化されているため、これを使用する系列は、非アクセラレーション系列で使用可能な多くの機能をサポートしていません:

  • 加速されたシリーズでは、シリーズのアニメーションはサポートされていません。
  • 加速度付きシリーズでは、ポイントラベルはサポートされていません。
  • 加速シリーズでは、ペンのスタイル、マーカーの形状、およびライトマーカーは無視されます。実線とプレーンなスキャッタードットのみがサポートされます。スキャッタードットは、基礎となるグラフィックスハードウェアとドライバによって、円形または長方形になります。
  • 極座標チャートは加速系列をサポートしません。
  • 加速系列を使用する場合、チャートのドロップシャドウを有効にしたり、透明なチャート背景色を使用することは推奨されません。

これらの追加制限は、accelerated seriesがチャートの上にある別のウィジェットに描画されることに起因しています:

  • 加速級数を含むチャートの上にグラフィック・アイテムを描画すると、加速級数はそれらのアイテムの上に描画されます。
  • QOpenGLWidget を部分的に透明にするには、他のすべてのウィジェットの上に重ねる必要があります。つまり、加速度系列を使用するときに、他のウィジェットがチャートを部分的に覆うことはできません。
  • 加速系列は、グラフィックス・シーンに複数のグラフィックス・ビューがアタッチされているような使用例ではサポートされていません。
  • 加速系列は、チャートがデフォルト以外のジオメトリを持つ使用例には対応していません。例えば、グラフィックスビューにトランスフォームを追加すると、加速系列がチャートに関連する正しくない位置に描画されます。

デフォルト値はfalse

アクセス関数:

bool useOpenGL() const
void setUseOpenGL(bool enable = true)

通知シグナル:

visible : bool

このプロパティは、系列が表示されているかどうかを保持します。

デフォルトではtrue

アクセス関数:

bool isVisible() const
void setVisible(bool visible = true)

通知シグナル:

メンバ関数 ドキュメント

[virtual noexcept] QAbstractSeries::~QAbstractSeries()

チャート系列の仮想デストラクタ。

bool QAbstractSeries::attachAxis(QAbstractAxis *axis)

axis で指定された軸をシリーズにアタッチします。

軸の取り付けに成功した場合はtrue を、そうでない場合はfalse を返す。

注意: 同じシリーズに同じ方向の複数の軸がアタッチされている場合、それらの軸は同じ最小値と最大値を持つ。

QChart::addAxis() およびQChart::createDefaultAxes()も参照

QList<QAbstractAxis *> QAbstractSeries::attachedAxes()

この系列にアタッチされている軸のリストを返します。通常、系列には x 軸と y 軸が付属しています。ただし、QPieSeries の系列には軸が付属していません。

attachAxis() およびdetachAxis()も参照のこと

QChart *QAbstractSeries::chart() const

系列が属するチャートを返します。

系列がチャートに追加されると自動的に設定され、系列がチャートから削除されると設定解除される。

bool QAbstractSeries::detachAxis(QAbstractAxis *axis)

axis で指定された軸を系列から切り離します。

軸が正常に切り離された場合はtrue を返し、そうでない場合はfalse を返す。

QChart::removeAxis()も参照

void QAbstractSeries::hide()

系列の可視性をfalse に設定する。

setVisible() およびisVisible() も参照

[signal] void QAbstractSeries::nameChanged()

このシグナルは、系列名が変更されたときに発行されます。

注: プロパティname の通知シグナル。

[signal] void QAbstractSeries::opacityChanged()

このシグナルは、系列の不透明度が変化したときに発せられる。

注: プロパティopacity のノーティファイアシグナル。

void QAbstractSeries::show()

シリーズの可視性をtrue に設定する。

setVisible() およびisVisible()も参照

[signal] void QAbstractSeries::useOpenGLChanged()

このシグナルは、OpenGLを使用した系列の描画の高速化が有効または無効の場合に発せられる。

注: プロパティuseOpenGL に対するノーティファイアシグナル。

[signal] void QAbstractSeries::visibleChanged()

このシグナルは、系列の可視性が変化したときに発せられる。

注: プロパティvisible のノーティファイアシグナル。

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