Log In
[Expand]Welcome to DevExpress .NET Documentation
[Expand]WinForms Controls
[Collapse]ASP.NET Controls and MVC Extensions
 [Expand]What's Installed
 [Expand]Common Concepts
 [Collapse]ASP.NET WebForms Controls
   Getting Started
  [Collapse]Chart Control
   [Expand]Product Information
   [Expand]Getting Started
    [Collapse]Creating Charts
     [Collapse]2D Chart Types
       Area Chart
       Bubble Chart
       Candle Stick Chart
       Doughnut Chart
       Nested Doughnut Chart
       Full-Stacked Area Chart
       Full-Stacked Bar Chart
       Full-Stacked Line Chart
       Full-Stacked Spline Area Chart
       Funnel Chart
       Line Chart
       Overlapped Gantt Chart
       Overlapped Range Bar Chart
       Pie Chart
       Point Chart
       Polar Area Chart
       Polar Line Chart
       Polar Point Chart
       Radar Area Chart
       Radar Line Chart
       Radar Point Chart
       Range Area Chart
       Scatter Line Chart
       Scatter Polar Line Chart
       Scatter Radar Line Chart
       Side-by-Side Bar Chart
       Side-by-Side Full-Stacked Bar Chart
       Side-by-Side Gantt Chart
       Side-by-Side Range Bar Chart
       Side-by-Side Stacked Bar Chart
       Spline Area Chart
       Spline Chart
       Stacked Area Chart
       Stacked Bar Chart
       Stacked Line Chart
       Stacked Spline Area Chart
       Step Area Chart
       Step Line Chart
       Stock Chart
       Swift Plot
     [Expand]3D Chart Types
     [Expand]Providing Data
     [Expand]Data Representation
     [Expand]Appearance Customization
    [Expand]Chart Elements
    [Expand]End-User Interaction
     Supported Browsers
     Adding a Web Chart
     Handling Client-side Scripts
     Medium Trust Support
     Web Farm and Web Gardens Support
   [Expand]Design-Time Features
   [Expand]Visual Elements
  [Expand]Grid View
  [Expand]Card View
  [Expand]Vertical Grid
  [Expand]Rich Text Editor
  [Expand]Image and Data Browsing
  [Expand]Docking and Popups
  [Expand]Site Navigation and Layout
  [Expand]File Management
  [Expand]Multi-Use Site Controls
  [Expand]HTML Editor
  [Expand]Pivot Grid
  [Expand]Tree List
  [Expand]Data Editors
  [Expand]Spell Checker
  [Expand]Query Builder
 [Expand]ASP.NET MVC Extensions
 [Expand]Redistribution and Deployment
  Get More Help
 [Expand]API Reference
[Expand]ASP.NET Bootstrap Controls
[Expand]ASP.NET Core Bootstrap Controls
[Expand]WPF Controls
[Expand]Xamarin Controls
[Expand]Windows 10 App Controls
[Expand]Document Server
[Expand]Report Server
[Expand]eXpressApp Framework
[Expand]CodeRush Classic
[Expand]Cross-Platform Core Libraries
[Expand]Tools and Utilities
 End-User Documentation

Candle Stick Chart

Expanded Short Description

The Candle Stick Chart is represented by the CandleStickSeriesView object, which belongs to Financial Series Views (also called Low-High-Open-Close).

This view is used to show the variation in the price of a stock over the course of a day. Each point consists of a rectangle (body - the bottom and top values of which correspond to the Open and Close prices) and a vertical line (shadow, wick or tail - the bottom and top values of which correspond to the Low and High prices). If the stock closes higher than its opening price, the body is hollow. And if the stock closes lower than its opening price, the body is filled.

For Candle Stick charts, you can set FinancialSeriesViewBase.ReductionOptions for a price level (Low, High, Open or Close), which displays a point in “red” (or other color) when the specified price is lower in comparison to the previous point value.

A Candle Stick chart is shown in the image below. Note that this chart type is based upon XYDiagram, so it can be rotated to show bars either vertically or horizontally.

To learn how to exclude holidays and weekends from an axis scale, refer to Data Aggregation.

See Financial Charting for more information.

Expanded Chart Type Characteristics

The table below lists the main characteristics of this chart type.



Series View type CandleStickSeriesView
Diagram type 2D-XYDiagram
Number of arguments per series point 1
Number of values per series point 4 (Low, High, Open, Close)

For information on which chart types can be combined with the Candle Stick Chart, refer to the Combining Different Series Views document.

Expanded Example

Show Me

A complete sample project is available in the DevExpress Code Examples database at http://www.devexpress.com/example=E1217.

This example demonstrates how to create a ChartControl with a series of the CandleStickSeriesView type, and add this chart to a form at runtime. Before proceeding with this example, create a Windows Forms Application in Visual Studio, and add all required assemblies to the References list of your project.

Then, add the following code to the Form.Load event handler.

Note that you can exclude non-working days (weekends and holidays) from an axis range via the DateTimeScaleOptions.WorkdaysOnly and DateTimeScaleOptions.WorkdaysOptions properties. Refer to Indicators for information on the financial indicators available for XtraCharts.

Expanded See Also

Is this topic helpful?​​​​​​​