Three Line Break Chart (Chart Controls)

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 KagiPoint 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.

Picture of the Three Line Break chart type

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

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.

    NoteNote

    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.

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"]["UsedYValue"]="3";

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";
Show: