corelibraries-devexpress-dot-xtracharts-dot-financialseriesviewbase.md
Gets the settings which relate to price reduction indication within the financial series.
Namespace : DevExpress.XtraCharts
Assembly : DevExpress.XtraCharts.v25.2.dll
NuGet Package : DevExpress.Charts
[PersistenceMode(PersistenceMode.InnerProperty)]
[XtraChartsLocalizableCategory(XtraChartsCategory.Data)]
public ReductionStockOptions ReductionOptions { get; }
<PersistenceMode(PersistenceMode.InnerProperty)>
<XtraChartsLocalizableCategory(XtraChartsCategory.Data)>
Public ReadOnly Property ReductionOptions As ReductionStockOptions
| Type | Description |
|---|---|
| ReductionStockOptions |
A ReductionStockOptions object that contains the price reduction indication settings.
|
The ReductionOptions property provides access to the settings that define how a price reduction is indicated within a series of the stock and candle stick types. The settings which are available via the ReductionOptions property allow you to define a particular price value (open, close, high or low) which the analysis of the price action is performed by, specify a color to indicate the price reduction and control whether price reductions are indicated within a series.
This example creates a ChartControl with a series of the CandleStickSeriesView type and adds this chart to a form at runtime. Before you proceed with this example, create a Windows Forms Application in Visual Studio and include all necessary assemblies in the References list of your project.
For more information about the features of financial charts, refer to the following help topic: Financial Charting
Note
A complete sample project is available at https://github.com/DevExpress-Examples/winforms-chart-create-candlestick-chart
using System;
using System.Collections.Generic;
using System.Drawing;
using System.Windows.Forms;
using DevExpress.XtraCharts;
namespace CandleStickChart {
public partial class Form1 : Form {
private void Form1_Load(object sender, EventArgs e) {
// Create a new chart.
ChartControl candlestickChart = new ChartControl();
// Create a candlestick series.
Series series1 = new Series("Series 1", ViewType.CandleStick);
// Bind the series to data.
series1.DataSource = GetDataPoints();
series1.SetFinancialDataMembers("Argument", "Low", "High", "Open", "Close");
// Specify that date-time arguments are expected.
series1.ArgumentScaleType = ScaleType.DateTime;
// Add the series to the chart.
candlestickChart.Series.Add(series1);
// Customize the series view settings.
CandleStickSeriesView view = (CandleStickSeriesView)series1.View;
view.LineThickness = 2;
view.LevelLineLength = 0.25;
// Specify the series reduction options.
view.ReductionOptions.ColorMode = ReductionColorMode.OpenToCloseValue;
view.ReductionOptions.FillMode = CandleStickFillMode.AlwaysEmpty;
view.ReductionOptions.Level = StockLevel.Close;
view.ReductionOptions.Visible = true;
// Set point colors.
view.Color = Color.Green;
view.ReductionOptions.Color = Color.Red;
// Access the chart's diagram.
XYDiagram diagram = (XYDiagram)candlestickChart.Diagram;
// Exclude empty ranges from the X-axis range
// to avoid gaps in the chart's data.
diagram.AxisX.DateTimeScaleOptions.SkipRangesWithoutPoints = true;
// Hide the range without points at the beginning of the y-axis.
diagram.AxisY.WholeRange.AlwaysShowZeroLevel = false;
// Hide the legend.
candlestickChart.Legend.Visibility = DevExpress.Utils.DefaultBoolean.False;
// Add a title to the chart.
candlestickChart.Titles.Add(new ChartTitle());
candlestickChart.Titles[0].Text = "Candlestick Chart";
// Add the chart to the form.
candlestickChart.Dock = DockStyle.Fill;
this.Controls.Add(candlestickChart);
}
List<DataPoint> GetDataPoints() {
List<DataPoint> dataPoints = new List<DataPoint> {
new DataPoint(DateTime.Now.AddDays(-9), 24.00, 25.00, 25.00, 24.875),
new DataPoint(DateTime.Now.AddDays(-8), 23.625, 25.125, 24.00, 24.875),
new DataPoint(DateTime.Now.AddDays(-7), 26.25, 28.25, 26.75, 27.00),
new DataPoint(DateTime.Now.AddDays(-6), 26.50, 27.875, 26.875, 27.25),
new DataPoint(DateTime.Now.AddDays(-4), 25.75, 26.875, 26.75, 26.00),
new DataPoint(DateTime.Now.AddDays(-3), 25.75, 26.75, 26.125, 26.25),
new DataPoint(DateTime.Now.AddDays(-2), 25.75, 26.375, 26.375, 25.875),
new DataPoint(DateTime.Now.AddDays(-1), 24.875, 26.125, 26.00, 25.375),
new DataPoint(DateTime.Now.AddDays(0), 25.125, 26.00, 25.625, 25.75),
};
return dataPoints;
}
}
public class DataPoint {
public DateTime Argument { get; set; }
public double Low { get; set; }
public double High { get; set; }
public double Open { get; set; }
public double Close { get; set; }
public DataPoint(DateTime argument, double low, double high, double open, double close) {
this.Argument = argument;
this.Low = low;
this.High = high;
this.Open = open;
this.Close = close;
}
}
}
Imports System
Imports System.Collections.Generic
Imports System.Drawing
Imports System.Windows.Forms
Imports DevExpress.XtraCharts
Namespace CandleStickChart
Public Partial Class Form1
Inherits Form
Private Sub Form1_Load(ByVal sender As Object, ByVal e As EventArgs)
' Create a new chart.
Dim candlestickChart As ChartControl = New ChartControl()
' Create a candlestick series.
Dim series1 As Series = New Series("Series 1", ViewType.CandleStick)
' Bind the series to data.
series1.DataSource = GetDataPoints()
series1.SetFinancialDataMembers("Argument", "Low", "High", "Open", "Close")
' Specify that date-time arguments are expected.
series1.ArgumentScaleType = ScaleType.DateTime
' Add the series to the chart.
candlestickChart.Series.Add(series1)
' Customize the series view settings.
Dim view As CandleStickSeriesView = CType(series1.View, CandleStickSeriesView)
view.LineThickness = 2
view.LevelLineLength = 0.25
' Specify the series reduction options.
view.ReductionOptions.ColorMode = ReductionColorMode.OpenToCloseValue
view.ReductionOptions.FillMode = CandleStickFillMode.AlwaysEmpty
view.ReductionOptions.Level = StockLevel.Close
view.ReductionOptions.Visible = True
' Set point colors.
view.Color = Color.Green
view.ReductionOptions.Color = Color.Red
' Access the chart's diagram.
Dim diagram As XYDiagram = CType(candlestickChart.Diagram, XYDiagram)
' Exclude empty ranges from the X-axis range
' to avoid gaps in the chart's data.
diagram.AxisX.DateTimeScaleOptions.SkipRangesWithoutPoints = True
' Hide the range without points at the beginning of the y-axis.
diagram.AxisY.WholeRange.AlwaysShowZeroLevel = False
' Hide the legend.
candlestickChart.Legend.Visibility = DevExpress.Utils.DefaultBoolean.[False]
' Add a title to the chart.
candlestickChart.Titles.Add(New ChartTitle())
candlestickChart.Titles(0).Text = "Candlestick Chart"
' Add the chart to the form.
candlestickChart.Dock = DockStyle.Fill
Me.Controls.Add(candlestickChart)
End Sub
Private Function GetDataPoints() As List(Of DataPoint)
Dim dataPoints As List(Of DataPoint) = New List(Of DataPoint) From {
New DataPoint(Date.Now.AddDays(-9), 24.00, 25.00, 25.00, 24.875),
New DataPoint(Date.Now.AddDays(-8), 23.625, 25.125, 24.00, 24.875),
New DataPoint(Date.Now.AddDays(-7), 26.25, 28.25, 26.75, 27.00),
New DataPoint(Date.Now.AddDays(-6), 26.50, 27.875, 26.875, 27.25),
New DataPoint(Date.Now.AddDays(-4), 25.75, 26.875, 26.75, 26.00),
New DataPoint(Date.Now.AddDays(-3), 25.75, 26.75, 26.125, 26.25),
New DataPoint(Date.Now.AddDays(-2), 25.75, 26.375, 26.375, 25.875),
New DataPoint(Date.Now.AddDays(-1), 24.875, 26.125, 26.00, 25.375),
New DataPoint(Date.Now.AddDays(0), 25.125, 26.00, 25.625, 25.75)
}
Return dataPoints
End Function
End Class
Public Class DataPoint
Public Property Argument As Date
Public Property Low As Double
Public Property High As Double
Public Property Open As Double
Public Property Close As Double
Public Sub New(ByVal argument As Date, ByVal low As Double, ByVal high As Double, ByVal open As Double, ByVal close As Double)
Me.Argument = argument
Me.Low = low
Me.High = high
Me.Open = open
Me.Close = close
End Sub
End Class
End Namespace
See Also