HiLo Bars
HiLo Bars are a series type in which the chart displays stock-like information using High and Low and/or Open and Close values. The overall length of the HiLo display is determined by the High and Low values, and the position of the open and close markers (or the open/close Box) is determined by the Open and Close values.
HiLoBar SeriesPoints are specified as: X, { High, Low [, Close [, Open [, Median [, ...] ] ] ] }, where brackets denote optional values. The chart control does not render values specified after the Median value, but the user can supply extra values, which can then be used in a pre/post render user callout to display additional rendered data from them (if desired).
HiLoBar displays can be rendered with two different HiLoBarSegment styles - the "DefaultSegment" and "AlternateSegment" styles. The use of each style is dependant upon whether the Alternate style is enabled for use, either explicitly or by default (as in the case of the Candle display), and whether or not the Close value is higher or lower than the Open value (Open low / Close high - Default, Open high /Close low - Alternate).
There are three types of HiLoBars availaible - each being displayable either horizontally (HorizontalHiLoBar) or vertically (VerticalHiLoBar). They are specified by setting the series HiLoBarType to one of the following:
Line
HiLoBarType Line specifies that the HiLoBar is to be displayed using only lines (no Boxes are present, as with both Box and Candle displays). The "range" (High/Low) values are represented by the entire length of the HiLo line. The "Open" value is presented as a tickmark/line on the left (when vetrical) or top (when horizontal) of the range line. The "Close" value is presented as a tickmark/line on the right (when vetrical) or bottom (when horizontal) of the range line. When "Median" values are provided (and displayed), they are represented as a tick-line that equidistantly crosses the range line at the median value.
Box
HiLoBarType Box specifies that the HiLoBar is to be displayed using a combination of lines (or Whiskers) and an Open/Close Box. The Whiskers extend from the top and bottom of the display (when displayed vertically) or the left and right (when displayed horizontally). The Whiskers denote the High and Low values, whereas the Box denotes the Open and Close values.
- UseAlternateSegmentStyle defaults to "False" for a Box display.
- When "Median" values are supplied, the Box display marks the median value with a line that crosses the display box. When the Close value is greater than the Open value, the upper portion of the box (or the entire area, when no Median value is specified) is filled with the "Default" background, with the lower portion (if a Median value is specified) being filled with the Alternate background. When the Open value is greater than the Close value, then the background areas are swapped and filled with the opposite background values.
Candle
HiLoBarType Candle specifies the High, Low, Close, and Open values identically to the HiLoBarType Box type. There are two main differences between the Candle and Box displays, and they are as follows:
- UseAlternateSegmentStyle defaults to "True" for a Candle display, whereas it defaults to "False" for all other displays (both Line and Box).
- When "Median" values are supplied, the Candle display marks the median value with a line that crosses the display box, identically to the Box display, however, the Box background is filled in a slightly different manner. The box background is always completely filled with either the default or alternate Box background (depending upon the direction of change between the Open and Close values), with no variance in the background with respect to the displayed median.
As with regular series Bars, Horizontal and Vertical HiLo Bars can be displayed side-by-side with other defined HiLo series bars. Their width can be proportionally set, as can the distance between bars of the same series, and bars of differing series. Horizontal bars can also be overlayed ontop of each other as well. Shading is supported for Box and Candle styles, with all styles supporting Pre and Post rengering of each individual bar segment.
The following sub-entries are ChartControl applications Demonstrating various presentations of HiLoBar series. The sample applications can be launched by either double-clicking on the outline entry to the left, or by clicking on the "Launch Sample Application" button at the bottom of the screen.
adrievx