TCandleSeries
Hierarchy Properties Methods Events
OHLC (Open,High,Low,Close) financial series.
Unit
CandleCh
Description
The Candle series outputs all points as vertical rectangles crossed by a vertical line.
To see a visual representation of this Series type, go to the TeeChart User Guide.
Each Candle point is made of four values that represent a Stock market session.
These are the HighValues, LowValues, OpenValues and CloseValues.
Set the ParentChart property to the desired Chart component.
Use the AddCandle method to manually fill Candle points:
Series1.AddCandle( EncodeDate( 2002, 10, 16), 100, 120, 80, 90 );
Note:
If you want to skip "weekends", pass an incremental integer number to Date parameter of AddCandle method:
var tmp : Integer;
tmp := Series1.AddCandle( Series1.Count, 100, 120, 80, 90 );
Series1.Label[ tmp ]:= DateToStr( EncodeDate( 2002, 10, 16 ));
The rectangles dimensions are determined by OpenValues and CloseValues properties.
The vertical line that crosses each candle point is defined by the HighValues and LowValues properties.
Candles can be drawn in different styles.
Use the CandleStyle property to choose the preferred mode: csCandleBar, csCandleStick, csOpenClose or csLine.
Candles with bigger Close than Open values are filled using the UpCloseColor property.
The other candles are filled using the DownCloseColor property.
When the Open price is equal to the Close price, then the color used to draw the candle is calculated as follows:
a) If Candle is the first one, then UpCloseColor is used.
b) If previous Close is higher, then DownCloseColor is used.
c) If previous Close is lower, then UpCloseColor is used.
d) If same as previous, then follow previous color.
You can control the candles width in pixels by using the CandleWidth property.
When drawing candles in csCandleBar mode, you can show or hide Open and Close values by using the ShowOpenTick and ShowCloseTick properties.
Please refer to TOHLCSeries ancestor description for all common Series properties like Marks, Axis dependence, methods and events.