Dundas Chart for Windows Forms
ChartArea Class
Members  See Also  Send comments on this topic.
DundasWinChart Assembly > Dundas.Charting.WinControl Namespace : ChartArea Class


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











Syntax

Visual Basic (Declaration)  
Public Class ChartArea 
   Inherits ChartArea3D
Visual Basic (Usage) Copy Code
Dim instance As ChartArea
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

See Also

© 2009 All Rights Reserved.