このページでは

QCandlestickSeries Class

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

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

このクラスは非推奨です。新しいコードでの使用は強く推奨しません。

プロパティ

パブリック関数

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 を使用する場合、各アイテムは独自のカテゴリに描画されます。QDateTimeAxis およびQValueAxis は、QBarCategoryAxis の代替として使用できます。この場合、各ローソク足アイテムは、そのタイムスタンプ値に基づいて描画されます。

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

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

1か月間の日足株価データを示したローソク足チャート。上昇は緑、下落は赤のローソク足で表示されている。

「 QCandlestickSet 」、「QBarCategoryAxis 」、「QDateTimeAxis 」、および「QValueAxis 」も参照してください 。

プロパティのドキュメント

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 : 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 で指定された単一のローソク足アイテムをシリーズに追加し、その所有権を取得します。アイテムが 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()

このシグナルは、ローソク足アイテム「caps」の表示状態が変化したときに発信されます。

注: プロパティ `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 で指定されたローソク足アイテムにマウスをホバーさせたときに発生します。

マウスがアイテムの上を移動すると、status はtrue に変わり、マウスが再びその場所から離れると、false に変わります。

[signal] void QCandlestickSeries::increasingColorChanged()

このシグナルは、ローソク足アイテムの増減を示す色が変化したときに発せられます。

注: プロパティ `increasingColor` に対する通知 信号です。

「increasingColor」も参照してください 。

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

set で指定されたローソク足アイテムを、index で指定された位置のシリーズに挿入します。アイテムの所有権を取得します。アイテムが 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 で指定された 1 つのローソク足アイテムを、シリーズから削除します。アイテムの削除に成功した場合はtrue を返し、それ以外の場合はfalse を返します。

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

sets で指定されたローソク足項目のリストを、シリーズから削除します。項目のいずれかが null である場合、すでにシリーズから削除されている場合、またはリストに複数回含まれている場合は、何も削除されません。すべての項目が正常に削除された場合は `true ` を返し、それ以外の場合は `false ` を返します。

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

そのシリーズに含まれるローソク足項目のリストを返します。項目の所有権は変更されません。

bool QCandlestickSeries::take(QCandlestickSet *set)

set で指定された単一のローソク足アイテムを、シリーズから取得します。アイテムは削除されません。取得操作が成功した場合はtrue を返し、それ以外の場合はfalse を返します。

注:シリーズは 引き続きその項目の親オブジェクトのままとなります。完全な所有権を取得するには、親オブジェクトを設定する必要があります。

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

プロパティ「QAbstractSeries::type 」のアクセス関数を再実装します。

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

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