Click here to Skip to main content
15,867,141 members
Articles / Programming Languages / C#
Article

Cristi Potlog's Chart Control for .NET

Rate me:
Please Sign up or sign in to vote.
4.60/5 (27 votes)
24 Jul 2005MIT5 min read 222.9K   11.6K   114   27
This article introduces a sample chart control for Windows Forms.

ChartControl Sample Image.

Introduction

There are a few samples of chart controls out there and a myriad of commercial chart controls. It seems that there is a large market and a strong need for such controls.

I will introduce here a sample chart control just for the sake of making an example. I can't guarantee, though, that it would fit any real world application requirements.

Background

The sample chart uses basic .NET drawing libraries, and there are no third party components. I will illustrate first a basic time-series line chart.

Using the code

To use the control, you need to add a reference to the compiled ChartControl.dll or you can use the source directly by adding the library to your solution. This should provide more flexibility and you can also change the code to fit your particular needs.

The control should appear on the toolbox now (the sample images assume that you are using source code reference):

ChartControl on the toolbox.

You can create a new form on your application project and place a chart control on the form. Set the Dock property to DockStyle.Fill and you will have something like this:

ChartControl with no settings and data.

You can start making changes to the default chart's properties to improve the visual effects of the chart:

ChartControl properties settings.

For a complete list of the settings, you can view the sample project. Then you can have something like what you see in the image at the top of the article.

Chart control details

The chart control is designed from a series of helper classes that hold specific information about how the control should be displayed. You'll notice that these classes are nested within each other so we can have a coherent model for the chart's components.

ChartTitleSettings class

Represents the display setting for a title of the chart control. Through its properties you can change the appearance of the title, both color and font, and also the text that will be displayed.

This class is used to represent the title of the chart, the title of the axis of the chart, and the title of the series.

ChartLabelsSettings class

Represents the display setting for labels of the chart control. The difference between a label and a title is that in a label you cannot control the text that is displayed. A label has, also, the possibility to rotate the text that it displays. You can choose not to display the label by setting the Visible property to False. You can obtain the same effect on a title by setting its title to an empty string.

This class is used to represent the labels that appear next to the chart's series values and the chart's axis pointers.

ChartLineSettings class

Represents the display setting for a line of the chart control. Through its properties you can set the color, weight and dash style of the line, as well as the fact that the line is visible or not.

This class is used to represent the lines of the chart's grid, axis, series and values projections, as well as the border lines of the chart's legend.

ChartGridSettings class

Represents the display setting for the grid of the chart control. You can set the settings of the grid line through a property of type ChartLineSettings. You can also specify the density of the grid by setting the XAxisStyle and YAxisStyle properties.

ChartMarkSettings class

Represents the display setting for a value mark of the chart control. You can change the appearance of the marks of the chart series value by setting fill color and border color and by selecting the shape of the mark from a list of predefined values:

C#
/// <summary>
/// Specifies the shapes of the value series marks for the chart control.
/// </summary>
public enum ChartMarkShapes
{
  None,
  Circle,
  Diamond,
  Square,
  Triangle
}

ChartProjectionsSettings class

Represents the display setting for the projections of the chart control. A projection is a line drawn from the value mark to the time axis to pin point the exact time frame of the value. It consists of a line and a label close to the axis that indicates the time.

You can control the appearance of the line and of the label through properties of type ChartLineSettings and ChartLabelSettings. You can specify if the projection should be displayed or not by setting the boolean Visible property.

ChartSeriesSettings class

Represents the setting for the time series of the chart control. This is a complex class compared with previous ones. You can control the settings of the series including the values to be displayed.

ChartLegendSettings class

Represents the display setting for the legend of the chart control. Through this class' properties, you can specify whether the legend will appear or not, the position at which it will be displayed, and the appearance of the border line of the legend.

Possible values for Position are:

C#
/// <summary>
/// Specifies the position at which the legend will be displayed on the chart control.
/// </summary>
public enum ChartMarkShapes
{
  Top,
  Left,
  Right,
  Bottom
}

ChartTimeScaleSettings class

Represents the setting for the time axis scale of the chart control. It provides properties to control the limits of the time scale.

ChartValueScaleSettings class

Represents the setting for the values axis scale of the chart control. It provides properties to control the limits of the value scale.

ChartTimeAxisSettings and ChartValueAxisSettings class

ChartTimeAxisSettings represents the display setting for the time axis of the chart control.

ChartValueAxisSettings represents the display setting for the value axis of the chart control.

Both these classes are derived from ChartAxisSettingsBase abstract class which provides the basic elements of the axis such as title, label, line and tick styles. Each class adds a Scale property of ChartTimeScaleSettings type and ChartValueScaleSettings type, respectively.

ChartSeriesValue and ChartSeriesValueCollection classes

ChartSeriesValue represents a value from the time series of the chart control. This class has two properties Date and Value that specify the data that should appear on the chart representing a certain value at a specific point in time.

ChartSeriesValueCollection represents a collection of values from the time series of the chart control.

Implementation notes class

This is to be considered work in progress. This is not the final nor the complete version of the control. I released the code so that I can get some feedback from you in order to add more features to it as well as to refine the design, especially the event model design.

Future directions

  • Multiple series support.
  • Designer support through custom editors.
  • More chart types support (e.g., bar chart, pie chart).

History

  • July 11th 2005. Initial release.
  • July 22nd 2005. Article contents update.

License

This article, along with any associated source code and files, is licensed under The MIT License


Written By
Software Developer
Romania Romania
This member has not yet provided a Biography. Assume it's interesting and varied, and probably something to do with programming.

Comments and Discussions

 
GeneralAdding a Third Y Axis Pin
Member 31521618-Mar-12 5:50
Member 31521618-Mar-12 5:50 
GeneralNew Version Pin
Akramany29-Jul-09 2:50
Akramany29-Jul-09 2:50 
Generalnice effort but... Pin
cinamon14-Jun-09 11:15
cinamon14-Jun-09 11:15 
GeneralChartTimeUnits Pin
Omar.Pessoa27-Apr-09 10:34
Omar.Pessoa27-Apr-09 10:34 
GeneralNew version Pin
Rovira25-Sep-07 22:42
Rovira25-Sep-07 22:42 
GeneralRe: New version Pin
Cristi Potlog7-Oct-07 11:32
Cristi Potlog7-Oct-07 11:32 
GeneralRe: New version Pin
dchris_med12-Feb-09 21:15
dchris_med12-Feb-09 21:15 
AnswerRe: New version Pin
Cristi Potlog13-Feb-09 22:16
Cristi Potlog13-Feb-09 22:16 
QuestionDouble Values on X-Axis? Pin
Titty16-Mar-07 0:25
Titty16-Mar-07 0:25 
GeneralAnother free chart Pin
Zvikabh6-Feb-07 4:06
Zvikabh6-Feb-07 4:06 
GeneralJFreeChart Pin
phirzel25-Jan-07 22:47
phirzel25-Jan-07 22:47 
Questionis it possible? Pin
ssouki23-Nov-06 0:14
ssouki23-Nov-06 0:14 
QuestionHow to make a curve Pin
Bugsaway9-Aug-06 10:51
Bugsaway9-Aug-06 10:51 
AnswerRe: How to make a curve Pin
Cristi Potlog14-Aug-06 10:30
Cristi Potlog14-Aug-06 10:30 
GeneralGreat Chart but... Pin
Andyc7616-Mar-06 1:09
Andyc7616-Mar-06 1:09 
AnswerRe: Great Chart but... Pin
Cristi Potlog16-Mar-06 3:07
Cristi Potlog16-Mar-06 3:07 
GeneralRe: Great Chart but... Pin
Dave Lenz15-May-06 17:46
Dave Lenz15-May-06 17:46 
Generaltime scale / multiple series Pin
Cole Cranford31-Jan-06 12:29
Cole Cranford31-Jan-06 12:29 
GeneralSelect parts of chart with mouse Pin
wizdd10-Jan-06 5:52
wizdd10-Jan-06 5:52 
AnswerRe: Select parts of chart with mouse Pin
Cristi Potlog10-Jan-06 21:17
Cristi Potlog10-Jan-06 21:17 
General"Measure" events Pin
wizdd10-Jan-06 5:45
wizdd10-Jan-06 5:45 
GeneralRe: "Measure" events Pin
Cristi Potlog10-Jan-06 21:12
Cristi Potlog10-Jan-06 21:12 
GeneralIs the hour Pin
negralina525-Aug-05 22:02
negralina525-Aug-05 22:02 
GeneralImpovement Pin
negralina525-Aug-05 21:22
negralina525-Aug-05 21:22 
AnswerRe: Impovement Pin
Cristi Potlog28-Aug-05 21:11
Cristi Potlog28-Aug-05 21:11 

General General    News News    Suggestion Suggestion    Question Question    Bug Bug    Answer Answer    Joke Joke    Praise Praise    Rant Rant    Admin Admin   

Use Ctrl+Left/Right to switch messages, Ctrl+Up/Down to switch threads, Ctrl+Shift+Left/Right to switch pages.