Three Line Break Chart
The Three Line Break chart type displays a series of vertical boxes, or lines, that reflect changes in price values. Similar to Kagi, Point and Figure, and Renko chart types, this chart type ignores the passage of time and emphasizes the changes in data trends.
This chart type is different from the Kagi, Point and Figure, and Renko chart types because there is no predetermined price change amount. It is the price action which gives the indication of a price change. The criterion for a new line on the chart requires that the data value breaks the high or the low of the preceding three lines by default. You can change this amount using the NumberOfLinesInBreak custom attribute.
Chart Characteristics
SeriesChartType value |
SeriesChartType.ThreeLineBreak |
Number of Y values per point |
1 |
Number of series |
1 |
Supports markers |
Yes |
Cannot be combined with: |
Any other chart type. |
Custom attributes |
NumberOfLinesInBreak, PixelPointDepth, PixelPointGapDepth, PriceUpColor, UsedYValue |
Remarks
Note the following when working with the Three Line Break chart type:
The X values of data points are automatically indexed. See Indexing Data Point X Value for more information.
The number of data points and the X-Y values that the chart displays is different from the original data. This is because a formula is applied to the original data before plotting.
It is recommended that you do not set the minimum or maximum values for the X axis, since you cannot determine how many data points are plotted after the formula is applied.
Note
If you do set the minimum or maximum value for the X axis, then you should also set the Maximum or Minimum properties to data point index values.
This chart type does not support data point anchoring and annotations.
You can select the up-trend color using the PriceUpColor custom attribute.
Selecting Y Values in a Series
If you have a data series with multiple Y values per data point, use the UsedYValue custom attribute to select the index of the Y value to use. By default, the Three Line Break chart uses the first value in DataPoint.YValues, which is found at index 0.
The following code selects the fourth Y value (index of 3) in the data points to plot on the Three Line Break chart.
Chart1.Series("Series1")("UsedYVale")="3"
Chart1.Series["Series1"]["UsedYValue"]="3";
Setting the Number of Lines in Break
To set the number of lines to break in the Three Line Break chart, use the NumberOfLinesInBreak custom attribute.
The following code sets the number of lines in break to 4. This causes the chart to draw a new line only when the data value breaks the high or the low of the preceding four lines.
Chart1.Series("Series1")("NumberOfLinesInBreak")="4"
Chart1.Series["Series1"]["NumberOfLinesInBreak"]="4";