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 を使用する場合、同じタイムスタンプを持つローソク足アイテムは互いに重なり合います。
ローソク足チャートの作成方法については、「ウィジェット付きチャート ギャラリー」を参照してください。

「 QCandlestickSet 」、「QBarCategoryAxis 」、「QDateTimeAxis 」、および「QValueAxis 」も参照してください 。
プロパティのドキュメント
bodyOutlineVisible : bool
このプロパティは、ローソク足の実体の輪郭の表示設定を保持します。
アクセス関数:
| bool | bodyOutlineVisible() const |
| void | setBodyOutlineVisible(bool bodyOutlineVisible) |
通知シグナル:
| void | bodyOutlineVisibilityChanged() |
bodyWidth : qreal
このプロパティは、ローソク足アイテムが自身のスロット内で占める相対的な幅を、0.0 から 1.0 の範囲で保持します。
この範囲外の値は、0.0 または 1.0 にクリップされます。
アクセス関数:
| qreal | bodyWidth() const |
| void | setBodyWidth(qreal bodyWidth) |
通知シグナル:
| void | bodyWidthChanged() |
brush : QBrush
このプロパティは、ローソク足アイテムの塗りつぶしに使用されるブラシを保持します。
アクセス関数:
| QBrush | brush() const |
| void | setBrush(const QBrush &brush) |
通知シグナル:
| void | brushChanged() |
capsVisible : bool
このプロパティは、キャップの表示状態を保持します。
アクセス関数:
| bool | capsVisible() const |
| void | setCapsVisible(bool capsVisible) |
通知シグナル:
| void | capsVisibilityChanged() |
capsWidth : qreal
このプロパティは、ローソク足内の高値・安値の相対的な幅を、0.0 から 1.0 の範囲で保持します。
この範囲外の値は、0.0 または 1.0 にクリップされます。
アクセス関数:
| qreal | capsWidth() const |
| void | setCapsWidth(qreal capsWidth) |
通知シグナル:
| void | capsWidthChanged() |
[read-only] count : int
このプロパティは、シリーズに含まれるローソク足項目の数を保持します。
アクセス関数:
| int | count() const |
通知信号:
| void | countChanged() |
decreasingColor : QColor
このプロパティは、下落するローソク足アイテムの本体の色を指定します。
ローソク足の始値が終値よりも高い場合、そのローソク足は下落とみなされます。デフォルトでは、このプロパティはアルファチャンネルが128に設定されたブラシ色に設定されています。また、プロパティに無効な色値が設定された場合も、デフォルト色が使用されます。
アクセス関数:
| QColor | decreasingColor() const |
| void | setDecreasingColor(const QColor &decreasingColor) |
通知シグナル:
| void | decreasingColorChanged() |
increasingColor : QColor
このプロパティは、上昇トレンドのローソク足の本体の色を指定します。
ローソク足の終値が始値よりも高い場合、そのローソク足は上昇とみなされます。デフォルトでは、このプロパティはブラシの色に設定されています。また、このプロパティに無効な色値が設定された場合も、デフォルトの色が使用されます。
アクセス関数:
| QColor | increasingColor() const |
| void | setIncreasingColor(const QColor &increasingColor) |
通知シグナル:
| void | increasingColorChanged() |
maximumColumnWidth : qreal
このプロパティは、ローソク足アイテムの最大幅をピクセル単位で指定します。負の値を設定すると、最大幅がないことを意味します。負の値はすべて -1.0 に変換されます。
アクセス関数:
| qreal | maximumColumnWidth() const |
| void | setMaximumColumnWidth(qreal maximumColumnWidth) |
通知シグナル:
| void | maximumColumnWidthChanged() |
minimumColumnWidth : qreal
このプロパティは、ローソク足アイテムの最小幅をピクセル単位で指定します。負の値を設定すると、最小幅がないことを意味します。負の値はすべて -1.0 に変換されます。
アクセス関数:
| qreal | minimumColumnWidth() const |
| void | setMinimumColumnWidth(qreal minimumColumnWidth) |
通知シグナル:
| void | minimumColumnWidthChanged() |
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.