Represents a chart area element in a chart image.
This class is used to create and display a chart area on the chart picture. The chart area is rectangle area on the chart picture, which has 4 axes, horizontal and vertical grids and different or same chart types. A Chart area can contain more than one different chart type. ChartArea class expose all the properties and methods of its base ChartArea3D class.
Object Model
  _210.gif) _210.gif) _210.gif) _210.gif) _210.gif) _210.gif) _210.gif) _210.gif) _210.gif)  _210.gif) |
Syntax
| Visual Basic (Declaration) | |
|---|---|
Public Class ChartArea Inherits ChartArea3D | |
| Visual Basic (Usage) |  Copy Code |
|---|---|
| |
| C# | |
|---|---|
public class ChartArea : ChartArea3D | |
Remarks
The ChartArea class represents one chart area within a chart image, and is used to plot one or more chart series. The number of chart series that can be plotted in a chart area is unlimited.
ChartArea objects are stored in the ChartAreaCollection class.
A ChartArea object:
- Uses one distinct inner plotting region.
- Is used to plot one or more chart series.
- Has primary and secondary x and y-axes, except for pie and doughnut chart types.
Note that some chart types cannot be plotted in the same chart area. For example, a pie chart cannot be displayed in the same chart area along with a line chart. For further details see the Chart Types Overview topic.
3D charts are displayed on a chart area-by-chart area basis. The Area3DStyle property allows for 3D charts to be enabled, and is also used for 3D styles and attributes. In addition the ChartArea class has useful methods for getting a series' Z position, a series' depth, as well as transforming relative 3D points to relative 2D points (must be done before performing any custom drawing routines on 3D charts). For more information on 3D see the Working with 3D Charts topic.
Important chart elements that are exposed by the ChartArea class are:
| ChartArea Element | Description |
|---|---|
| Axes | The axes of a chart area. |
| Position | The position of the chart area. |
| Inner Plot Position | Inner plotting position, which can be used to change the size of a plotted chart within the chart area (e.g. increase the size of a pie chart). For a detailed description of the Chart's coordinate system click here. |
To not display a series set the ChartArea property of that series to a zero-length string.
Inheritance Hierarchy
System.Object
Dundas.Charting.WinControl.ChartElement
Dundas.Charting.WinControl.ChartAreaAxes
Dundas.Charting.WinControl.ChartArea3D
Dundas.Charting.WinControl.ChartArea
Requirements
Target Platforms: Windows 98, Windows NT 4.0, Windows Millennium Edition, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003 family, Windows Vista, Windows Server 2008 family