QCandlestickSeries Class

QCandlestickSeries クラスは、ローソク足としてデータを表示します。詳細...

Header: #include <QCandlestickSeries>
In QML: CandlestickSeries
Inherits: QAbstractSeries

プロパティ

パブリック関数

QCandlestickSeries(QObject *parent = nullptr)
virtual ~QCandlestickSeries()
bool append(QCandlestickSet *set)
bool append(const QList<QCandlestickSet *> &sets)
bool bodyOutlineVisible() const
qreal bodyWidth() const
QBrush brush() const
bool capsVisible() const
qreal capsWidth() const
void clear()
int count() const
QColor decreasingColor() const
QColor increasingColor() const
bool insert(int index, QCandlestickSet *set)
qreal maximumColumnWidth() const
qreal minimumColumnWidth() const
QPen pen() const
bool remove(QCandlestickSet *set)
bool remove(const QList<QCandlestickSet *> &sets)
void setBodyOutlineVisible(bool bodyOutlineVisible)
void setBodyWidth(qreal bodyWidth)
void setBrush(const QBrush &brush)
void setCapsVisible(bool capsVisible)
void setCapsWidth(qreal capsWidth)
void setDecreasingColor(const QColor &decreasingColor)
void setIncreasingColor(const QColor &increasingColor)
void setMaximumColumnWidth(qreal maximumColumnWidth)
void setMinimumColumnWidth(qreal minimumColumnWidth)
void setPen(const QPen &pen)
QList<QCandlestickSet *> sets() const
bool take(QCandlestickSet *set)

再実装パブリック関数

virtual QAbstractSeries::SeriesType type() const override

シグナル

void bodyOutlineVisibilityChanged()
void bodyWidthChanged()
void brushChanged()
void candlestickSetsAdded(const QList<QCandlestickSet *> &sets)
void candlestickSetsRemoved(const QList<QCandlestickSet *> &sets)
void capsVisibilityChanged()
void capsWidthChanged()
void clicked(QCandlestickSet *set)
void countChanged()
void decreasingColorChanged()
void doubleClicked(QCandlestickSet *set)
void hovered(bool status, QCandlestickSet *set)
void increasingColorChanged()
void maximumColumnWidthChanged()
void minimumColumnWidthChanged()
void penChanged()
void pressed(QCandlestickSet *set)
void released(QCandlestickSet *set)

詳細説明

このクラスは、単一のローソク足アイテムのコンテナとして動作します。QBarCategoryAxis QDateTimeAxisQValueAxis は、QBarCategoryAxis の代替として使用できます。 この場合、各ローソク足アイテムは、そのタイムスタンプ値に従って描画されます。

注意: タイムスタンプは QCandlestickSeries 内で一意でなければなりません。QBarCategoryAxis を使用する場合、タイムスタンプを共有するローソク足アイテムの最初のものだけが描画されます。チャートに複数の QCandlestickSeries インスタンスが含まれる場合、タイムスタンプを共有する異なるシリーズのアイテムが同じカテゴリに描画されます。QValueAxis またはQDateTimeAxis を使用している場合、タイムスタンプを共有するローソク足アイテムは互いに重なります。

ローソク足チャートの作成方法については、ウィジェットを使ったチャート・ギャラリーを参照してください。

QCandlestickSetQBarCategoryAxisQDateTimeAxisQValueAxisも参照して ください。

プロパティ・ドキュメンテーション

bodyOutlineVisible : bool

このプロパティは、ローソク足ボディのアウトラインの可視性を保持します。

アクセス関数

bool bodyOutlineVisible() const
void setBodyOutlineVisible(bool bodyOutlineVisible)

通知シグナル

bodyWidth : qreal

このプロパティは、0.0 から 1.0 の範囲で、自身のスロット内のローソク足アイテムの相対的な幅を保持する。

この範囲外の値は0.0または1.0にクランプされます。

アクセス関数:

qreal bodyWidth() const
void setBodyWidth(qreal bodyWidth)

通知シグナル:

brush : QBrush

このプロパティは、ローソク足アイテムの塗りつぶしに使用されるブラシを保持します。

アクセス関数

QBrush brush() const
void setBrush(const QBrush &brush)

通知シグナル

void brushChanged()

capsVisible : bool

このプロパティは、キャップの可視性を保持する。

アクセス関数

bool capsVisible() const
void setCapsVisible(bool capsVisible)

通知シグナル

capsWidth : qreal

このプロパティは、ローソク足内のキャップの相対的な幅を0.0から1.0の範囲で保持する。

この範囲外の値は0.0または1.0にクランプされる。

アクセス関数:

qreal capsWidth() const
void setCapsWidth(qreal capsWidth)

通知シグナル:

[read-only] count : const int

このプロパティは、ローソク足の本数を保持します。

アクセス関数:

int count() const

通知シグナル

void countChanged()

decreasingColor : QColor

このプロパティは、減少するローソク足アイテムのボディの色を保持します。

ローソク足が減少しているのは、始値が終値より高い場合です。デフォルトでは、このプロパティはアルファチャンネルを128に設定したブラシの色に設定されます。このプロパティが無効な色値に設定されている場合も、デフォルトの色が使用されます。

アクセス関数:

QColor decreasingColor() const
void setDecreasingColor(const QColor &decreasingColor)

通知シグナル:

increasingColor : QColor

このプロパティは、増加するローソク足アイテムのボディの色を保持します。

ローソク足は、その終値が始値よりも高いとき、上昇しています。デフォルトでは、このプロパティはブラシの色に設定されています。このプロパティに無効な色が設定されている場合も、デフォルトの色が使用されます。

アクセス関数

QColor increasingColor() const
void setIncreasingColor(const QColor &increasingColor)

通知シグナル

maximumColumnWidth : qreal

このプロパティは、ローソク足アイテムの最大幅をピクセル単位で保持する。負の値を設定することは、最大幅がないことを意味します。すべての負の値は-1.0に変換されます。

アクセス関数:

qreal maximumColumnWidth() const
void setMaximumColumnWidth(qreal maximumColumnWidth)

通知シグナル:

minimumColumnWidth : qreal

このプロパティは、ローソク足アイテムの最小幅をピクセル単位で保持する。負の値を設定することは、最小幅がないことを意味します。すべての負の値は-1.0に変換されます。

アクセス関数:

qreal minimumColumnWidth() const
void setMinimumColumnWidth(qreal minimumColumnWidth)

通知シグナル:

pen : QPen

このプロパティは、ローソク足アイテムのラインを描画するために使用されるペンを保持します。

アクセス関数

QPen pen() const
void setPen(const QPen &pen)

通知シグナル

void penChanged()

メンバー関数ドキュメント

[explicit] QCandlestickSeries::QCandlestickSeries(QObject *parent = nullptr)

空の QCandlestickSeries を構築する。parent はオプションです。

[virtual noexcept] QCandlestickSeries::~QCandlestickSeries()

系列を破棄します。チャートから系列を削除します。

bool QCandlestickSeries::append(QCandlestickSet *set)

set で指定されたローソク足を1つシリーズに追加し、その所有権を取得します。アイテムがNULLまたは既にシリーズに含まれている場合、追加されません。追加に成功した場合はtrue を、失敗した場合はfalse を返す。

bool QCandlestickSeries::append(const QList<QCandlestickSet *> &sets)

sets で指定されたローソク足アイテムのリストをシリーズに追加し、その所有権を取得します。項目のいずれかがNULLであるか、既にシリーズに属しているか、リストに複数回出現している場合、何も追加されない。すべての項目の追加に成功した場合はtrue を、そうでない場合はfalse を返す。

[signal] void QCandlestickSeries::bodyOutlineVisibilityChanged()

このシグナルは、ローソク足アイテムのアウトラインの可視性が変化した時に発信されます。

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

bodyOutlineVisibleも参照してください

[signal] void QCandlestickSeries::bodyWidthChanged()

このシグナルは、ローソク足アイテムの幅が変化した時に発信されます。

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

bodyWidthも参照

[signal] void QCandlestickSeries::brushChanged()

このシグナルは、ローソク足アイテムのブラシが変更された時に発信されます。

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

brushも参照

[signal] void QCandlestickSeries::candlestickSetsAdded(const QList<QCandlestickSet *> &sets)

このシグナルは、sets で指定されたローソク足がシリーズに追加された時に発信されます。

[signal] void QCandlestickSeries::candlestickSetsRemoved(const QList<QCandlestickSet *> &sets)

このシグナルは、sets で指定されたローソク足がシリーズから削除されたときに発信されます。

[signal] void QCandlestickSeries::capsVisibilityChanged()

このシグナルは、ローソク足アイテムのキャップの可視性が変化したときに発信されます。

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

capsVisibleも参照

[signal] void QCandlestickSeries::capsWidthChanged()

このシグナルは、ローソク足アイテムのキャップ幅が変更された時に発信されます。

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

capsWidthも参照

void QCandlestickSeries::clear()

シリーズからすべてのローソク足アイテムを削除し、永久に削除します。

[signal] void QCandlestickSeries::clicked(QCandlestickSet *set)

このシグナルは、set で指定されたローソク足がチャート上でクリックされたときに発信されます。

int QCandlestickSeries::count() const

ローソク足の本数を返します。

注: プロパティ count のゲッター関数です。

[signal] void QCandlestickSeries::countChanged()

このシグナルは、シリーズ内のローソク足アイテムの数が変化した時に発信される。

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

countも参照

[signal] void QCandlestickSeries::decreasingColorChanged()

このシグナルは、ローソク足アイテムの減少色が変化した時に発信されます。

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

decreasingColorも参照

[signal] void QCandlestickSeries::doubleClicked(QCandlestickSet *set)

このシグナルは、set で指定されたローソク足がチャート上でダブルクリックされたときに発信されます。

[signal] void QCandlestickSeries::hovered(bool status, QCandlestickSet *set)

このシグナルは、チャートのset で指定されたローソク足アイテムの上にマウスが置かれたときに発せられます。

マウスがアイテムの上に移動すると、statustrue に変わり、マウスが再び離れると、false に変わります。

[signal] void QCandlestickSeries::increasingColorChanged()

このシグナルは、ローソク足アイテムの増加色が変化した時に発信されます。

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

increasingColorも参照

bool QCandlestickSeries::insert(int index, QCandlestickSet *set)

index で指定された位置のシリーズに、set で指定されたローソク足を挿入します。アイテムの所有権を取得します。アイテムがNULLまたは既にシリーズに属している場合、アイテムは挿入されません。挿入に成功した場合はtrue を、失敗した場合はfalse を返す。

[signal] void QCandlestickSeries::maximumColumnWidthChanged()

このシグナルは、ローソク足アイテムの最大列幅が変更された時に発信される。

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

maximumColumnWidthも参照

[signal] void QCandlestickSeries::minimumColumnWidthChanged()

このシグナルは、ローソク足アイテムの最小列幅が変更された時に発信される。

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

minimumColumnWidthも参照

[signal] void QCandlestickSeries::penChanged()

このシグナルは、ローソク足アイテムのペンが変化した時に発信されます。

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

penも参照

[signal] void QCandlestickSeries::pressed(QCandlestickSet *set)

このシグナルは、set で指定されたローソク足アイテムをクリックし、マウスボタンを押し続けたときに発信されます。

[signal] void QCandlestickSeries::released(QCandlestickSet *set)

このシグナルは、set で指定されたローソク足アイテムの上でマウスを離したときに発せられます。

bool QCandlestickSeries::remove(QCandlestickSet *set)

set で指定された単一のローソク足アイテムをシリーズから削除する。項目の削除に成功した場合はtrue を、失敗した場合はfalse を返します。

bool QCandlestickSeries::remove(const QList<QCandlestickSet *> &sets)

sets で指定したローソク足アイテムのリストをシリーズから削除します。項目のいずれかがNULLであるか、既にシリーズから削除されているか、リストに複数回表示されている場合、何も削除されません。すべての項目の削除に成功した場合はtrue を、そうでない場合はfalse を返す。

QList<QCandlestickSet *> QCandlestickSeries::sets() const

シリーズ内のローソク足アイテムのリストを返します。アイテムの所有権は変更されません。

bool QCandlestickSeries::take(QCandlestickSet *set)

set で指定されたローソク足をシリーズから1つ取り出します。アイテムは削除されない。取得が成功した場合はtrue を、失敗した場合はfalse を返します。

注意: シリーズはアイテムの親オブジェクトのままです。完全な所有権を取得するには、親オブジェクトを設定する必要があります。

[override virtual] QAbstractSeries::SeriesType QCandlestickSeries::type() const

QAbstractSeries::type プロパティへのアクセス関数を再インプリメント。

系列の型を返します (QAbstractSeries::SeriesTypeCandlestick)。

© 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.