CandlestickSeries QML Type
一連のデータをローソク足として表示します。詳細...
| Import Statement: | import QtCharts 2.12 |
| Since: | QtCharts 2.2 |
| In C++: | QCandlestickSeries |
| Inherits: | |
| Status: | Deprecated |
この型は非推奨です。新しいコードでの使用は強く推奨しません。
プロパティ
- axisX : AbstractAxis
- axisXTop : AbstractAxis
- axisY : AbstractAxis
- axisYRight : AbstractAxis
- bodyOutlineVisible : bool
- bodyWidth : real
- brushFilename : string
- capsVisible : bool
- capsWidth : real
- count : int
- decreasingColor : color
- increasingColor : color
- maximumColumnWidth : real
- minimumColumnWidth : real
信号
- candlestickSetsAdded(list<CandlestickSet> sets)
- candlestickSetsRemoved(list<CandlestickSet> sets)
- clicked(CandlestickSet set)
- doubleClicked(CandlestickSet set)
- hovered(bool status, CandlestickSet set)
- pressed(CandlestickSet set)
- released(CandlestickSet set)
方法
- bool append(CandlestickSet set)
- CandlestickSet at(int index)
- void clear()
- bool insert(int index, CandlestickSet set)
- bool remove(CandlestickSet set)
詳細な説明
CandlestickSeries 型は、個々のローソク足アイテムを格納するコンテナとして機能します。BarCategoryAxis を使用する場合、各アイテムはそれぞれのカテゴリに描画されます。BarCategoryAxis の代わりに、DateTimeAxis およびValueAxis を使用することも可能です。この場合、各ローソク足アイテムは、そのタイムスタンプ値に基づいて描画されます。
注: タイムスタンプは 、CandlestickSeries 内で一意である必要があります。BarCategoryAxis を使用する場合、同じタイムスタンプを持つローソク足アイテムのうち、最初の1つだけが描画されます。チャートに複数のCandlestickSeriesインスタンスが含まれている場合、異なるシリーズに属するものの同じタイムスタンプを持つアイテムは、同じカテゴリに描画されます。ValueAxis またはDateTimeAxis を使用する場合、同じタイムスタンプを持つローソク足アイテムは互いに重なり合います。
以下のQMLは、簡単なローソク足チャートの作成方法を示しています:
import QtQuick 2.5
import QtCharts 2.2
ChartView {
title: "Candlestick Series"
width: 400
height: 300
CandlestickSeries {
name: "Acme Ltd."
increasingColor: "green"
decreasingColor: "red"
CandlestickSet { timestamp: 1435708800000; open: 690; high: 694; low: 599; close: 660 }
CandlestickSet { timestamp: 1435795200000; open: 669; high: 669; low: 669; close: 669 }
CandlestickSet { timestamp: 1436140800000; open: 485; high: 623; low: 485; close: 600 }
CandlestickSet { timestamp: 1436227200000; open: 589; high: 615; low: 377; close: 569 }
CandlestickSet { timestamp: 1436313600000; open: 464; high: 464; low: 254; close: 254 }
}
}
CandlestickSet 、BarCategoryAxis 、DateTimeAxis 、およびValueAxisも参照してください 。
プロパティのドキュメント
axisX : AbstractAxis
この系列に使用されるx軸。axisXとaxisXTop の両方を未定義のままにすると、その系列用に値軸が作成されます。
「 axisXTop 」および「ValueAxis 」も参照してください 。
axisXTop : AbstractAxis
チャートビューの上に描画される、この系列に使用されるx軸。
注: axisX と axisXTop の両方を指定することはできず、どちらか一方のみを指定できます 。
「axisX」も参照してください 。
axisY : AbstractAxis
この系列に使用されるY軸。axisYとaxisYRight の両方を未定義のままにすると、その系列に対して値軸が作成されます。
「 axisYRight 」および「ValueAxis 」も参照してください 。
axisYRight : AbstractAxis
チャートビュー上で右側に描画される、この系列に使用されるY軸。
注: axisY と axisYRight の両方を指定することはできず、どちらか一方のみを指定できます 。
「axisY」も参照してください 。
bodyOutlineVisible : bool
ローソク足の実体の輪郭の表示。
bodyWidth : real
各スロット内におけるローソク足アイテムの相対的な幅。範囲は 0.0 から 1.0 です。この範囲外の値は、0.0 または 1.0 にクリップされます。
brushFilename : string
このシリーズでブラシ画像として使用されるファイルの名前。
capsVisible : bool
キャップの視認性。
capsWidth : real
ローソク足内のキャップの相対的な幅で、0.0 から 1.0 の範囲で表されます。この範囲外の値は、0.0 または 1.0 にクリップされます。
count : int [read-only]
シリーズに含まれるローソク足項目の数。
decreasingColor : color
下落ローソク足の本体の色。ローソク足は、始値が終値よりも高い場合、下落ローソク足となります。デフォルトでは、このプロパティはアルファチャンネルが128に設定されたブラシの色に設定されています。また、このプロパティに無効な色値が設定された場合も、デフォルトの色が使用されます。
increasingColor : color
上昇トレンドのローソク足の実体の色。ローソク足は、終値が始値よりも高い場合に上昇トレンドとなります。デフォルトでは、このプロパティはブラシの色に設定されています。また、このプロパティに無効な色の値が設定された場合も、デフォルトの色が使用されます。
maximumColumnWidth : real
ローソク足アイテムの最大幅(ピクセル単位)。負の値を指定すると、最大幅は設定されません。負の値はすべて -1.0 に変換されます。
minimumColumnWidth : real
ローソク足アイテムの最小幅(ピクセル単位)。負の値を設定すると、最小幅は設定されません。負の値はすべて -1.0 に変換されます。
Signal ドキュメント
candlestickSetsAdded(list<CandlestickSet> sets)
このシグナルは、sets で指定されたローソク足アイテムがシリーズに追加されたときに発火します。
対応するシグナルハンドラはonCandlestickSetsAdded です。
注: 対応するハンドラは onCandlestickSetsAdded です。
candlestickSetsRemoved(list<CandlestickSet> sets)
sets で指定されたローソク足アイテムがシリーズから削除されたときに、このシグナルが発信されます。
対応するシグナルハンドラはonCandlestickSetsRemoved です。
注: 対応するハンドラは onCandlestickSetsRemoved です。
clicked(CandlestickSet set)
このシグナルは、チャート上で `set ` で指定されたローソク足アイテムがクリックされたときに発生します。
対応するシグナルハンドラはonClicked です。
注: 対応するハンドラは `onClicked` です。
doubleClicked(CandlestickSet set)
このシグナルは、set で指定されたローソク足アイテムをチャート上でダブルクリックしたときに発生します。
対応するシグナルハンドラはonDoubleClicked です。
注: 対応するハンドラは onDoubleClicked です。
hovered(bool status, CandlestickSet set)
このシグナルは、チャート上でset で指定されたローソク足アイテムにマウスをホバーさせたときに発生します。
マウスがアイテムの上を移動すると、status はtrue となり、マウスが再びその位置から離れると、false となります。
対応するシグナルハンドラは `onHovered` です。
注: 対応するハンドラは onHovered です。
pressed(CandlestickSet set)
このシグナルは、ユーザーが `set ` で指定されたローソク足アイテムをクリックし、マウスボタンを押し続けたときに発生します。
対応するシグナルハンドラは `onPressed` です。
注: 対応するハンドラは `onPressed` です。
released(CandlestickSet set)
このシグナルは、set で指定されたローソク足アイテム上で、ユーザーがマウスのクリックを解除したときに発生します。
対応するシグナルハンドラはonReleased です。
注: 対応するハンドラは onReleased です。
メソッドのドキュメント
bool append(CandlestickSet set)
set で指定された単一のローソク足アイテムをシリーズに追加し、その所有権を取得します。アイテムが null の場合、またはすでにシリーズに含まれている場合は、追加されません。
追加に成功した場合は `true ` を返し、失敗した場合は `false ` を返します。
CandlestickSet at(int index)
index で指定された位置にあるローソク足アイテムを返します。インデックスが無効な場合はnullを返します。
void clear()
そのシリーズからすべてのローソク足アイテムを削除し、完全に消去します。
bool insert(int index, CandlestickSet set)
set で指定されたローソク足アイテムを、index で指定された位置のシリーズに挿入します。アイテムの所有権を取得します。アイテムが null であるか、すでにそのシリーズに属している場合は、挿入されません。
挿入に成功した場合は `true ` を返し、それ以外の場合は `false ` を返します。
bool remove(CandlestickSet set)
set で指定された 1 つのローソク足アイテムを、シリーズから削除します。
項目の削除に成功した場合はtrue を返し、それ以外の場合はfalse を返します。
© 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.