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 |
シグナル
void | nameChanged() |
void | opacityChanged() |
void | useOpenGLChanged() |
void | visibleChanged() |
QXYSeries,QLineSeries,QSplineSeries,QScatterSeries,QAreaSeries,QAbstractBarSeries,QBarSeries,QStackedBarSeries,QPercentBarSeries,QHorizontalBarSeries,QHorizontalStackedBarSeries,QHorizontalPercentBarSeries,QPieSeriesも参照のこと 。
メンバ型ドキュメント
enum QAbstractSeries::SeriesType
この列挙型は系列の型を記述する。
定数 | 値 | 説明 |
---|---|---|
QAbstractSeries::SeriesTypeLine | 0 | 折れ線グラフ |
QAbstractSeries::SeriesTypeArea | 1 | エリアチャート |
QAbstractSeries::SeriesTypeBar | 2 | 垂直棒グラフ |
QAbstractSeries::SeriesTypeStackedBar | 3 | 垂直積み上げ棒グラフ |
QAbstractSeries::SeriesTypePercentBar | 4 | 垂直パーセント棒グラフ |
QAbstractSeries::SeriesTypePie | 5 | 円グラフ |
QAbstractSeries::SeriesTypeScatter | 6 | 散布図 |
QAbstractSeries::SeriesTypeSpline | 7 | スプラインチャート |
QAbstractSeries::SeriesTypeHorizontalBar | 8 | 水平棒グラフ |
QAbstractSeries::SeriesTypeHorizontalStackedBar | 9 | 水平積み上げ棒グラフ |
QAbstractSeries::SeriesTypeHorizontalPercentBar | 10 | 水平パーセント棒グラフ |
QAbstractSeries::SeriesTypeBoxPlot | 11 | ボックス・プロット・チャート |
QAbstractSeries::SeriesTypeCandlestick | 12 | ローソク足チャート |
プロパティの説明
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) |
通知シグナル:
void | opacityChanged() |
[read-only]
type : const SeriesType
このプロパティは系列のタイプを保持する。
アクセス関数:
virtual QAbstractSeries::SeriesType | type() const = 0 |
useOpenGL : bool
アクセス関数:系列の描画を OpenGL を用いて高速化するか否かを指定する。
OpenGL による高速化はQLineSeries とQScatterSeries でのみサポートされる。QAreaSeries のエッジ系列として使用される線系列は、OpenGL アクセラレーションを使用できない。チャートに OpenGL で描画される系列が含まれる場合、チャートのプロット領域の上に透明な QOpenGLWidget が作成されます。アクセラレーションされた系列は、その下にあるQGraphicsView には描画されず、作成された QOpenGLWidget に描画されます。
OpenGLを使用して系列描画を高速化することで得られるパフォーマンスは、基盤となるハードウェアに依存しますが、ほとんどの場合、それは重要です。たとえば、標準的なデスクトップ・コンピュータでは、系列に対してOpenGLアクセラレーションを有効にすると、通常、フレーム・レートを低下させることなく、少なくとも100倍多くのポイントをレンダリングできます。チャートのサイズもフレームレートにあまり影響しません。
直列描画のOpenGLアクセラレーションは、大量のポイントを高速に描画する必要があるユースケースを想定しています。これは効率化のために最適化されているため、これを使用する系列は、非アクセラレーション系列で使用可能な多くの機能をサポートしていません:
- 加速されたシリーズでは、シリーズのアニメーションはサポートされていません。
- 加速度付きシリーズでは、ポイントラベルはサポートされていません。
- 加速シリーズでは、ペンのスタイル、マーカーの形状、およびライトマーカーは無視されます。実線とプレーンなスキャッタードットのみがサポートされます。スキャッタードットは、基礎となるグラフィックスハードウェアとドライバによって、円形または長方形になります。
- 極座標チャートは加速系列をサポートしません。
- 加速系列を使用する場合、チャートのドロップシャドウを有効にしたり、透明なチャート背景色を使用することは推奨されません。
これらの追加制限は、accelerated seriesがチャートの上にある別のウィジェットに描画されることに起因しています:
- 加速級数を含むチャートの上にグラフィック・アイテムを描画すると、加速級数はそれらのアイテムの上に描画されます。
- QOpenGLWidget を部分的に透明にするには、他のすべてのウィジェットの上に重ねる必要があります。つまり、加速度系列を使用するときに、他のウィジェットがチャートを部分的に覆うことはできません。
- 加速系列は、グラフィックス・シーンに複数のグラフィックス・ビューがアタッチされているような使用例ではサポートされていません。
- 加速系列は、チャートがデフォルト以外のジオメトリを持つ使用例には対応していません。例えば、グラフィックスビューにトランスフォームを追加すると、加速系列がチャートに関連する正しくない位置に描画されます。
デフォルト値はfalse
。
アクセス関数:
bool | useOpenGL() const |
void | setUseOpenGL(bool enable = true) |
通知シグナル:
void | useOpenGLChanged() |
visible : bool
このプロパティは、系列が表示されているかどうかを保持します。
デフォルトではtrue
。
アクセス関数:
bool | isVisible() const |
void | setVisible(bool visible = true) |
通知シグナル:
void | visibleChanged() |
メンバ関数 ドキュメント
[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.の 商標です。その他すべての商標は、それぞれの所有者に帰属します。