ChartArea ChartArea ChartArea ChartArea Class

Definition

Represents a chart area on the chart image.

public ref class ChartArea : System::Windows::Forms::DataVisualization::Charting::ChartNamedElement
public class ChartArea : System.Windows.Forms.DataVisualization.Charting.ChartNamedElement
type ChartArea = class
    inherit ChartNamedElement
Public Class ChartArea
Inherits ChartNamedElement
Inheritance

Remarks

Within any given chart, the inner plot position is the rectangular area, inside the x and y-axis lines, where the data points are drawn. The plot position is the rectangular area that encompasses the inner plot position, the tick marks, and the axis labels. The chart area is the rectangular area that encompasses the plot position, the tick marks, the axis labels and the axis titles on the chart.

A chart area is represented by a ChartArea class; ChartArea objects are stored in the ChartAreaCollection class.

The number of chart series that can be plotted in a chart area is unlimited.

A ChartArea object:

  • Uses one distinct inner plotting area.

  • Is used to plot one or more chart series.

  • Has primary and secondary x and y-axes, except for pie and doughnut chart types.

When you use Shape chart types, which includes pie, doughnut, funnel, pyramid, polar, and radar charts, the inner plotting position defines the size of the chart type shape. For example, when you increase the value of the InnerPlotPosition property on a pie chart, you will increase the radius of the pie shape.

For all other chart types, each chart area has two sets of X- and Y-axes, primary and secondary. To access properties related to these axes, use the AxisX, AxisX2, AxisY and AxisY2 properties. If you need to set a property that affects all axes on the chart, use the Axes property.

One or more series are associated with a chart area. The series has a ChartArea property that determines the chart area that each series belongs to. By default, the series is connected to the default chart area. To disable the display of a series, set the ChartArea property of that series to a zero-length string.

If another chart area is added to the chart, you can associate any series with the new chart area. In all Shape chart types, as well as bar and stacked bar chart types, each series must be plotted in a separate chart area. In all other chart types, multiple series can be combined in the same chart area.

A 3D chart is displayed on a chart area-by-chart area basis. You can use the Area3DStyle property to enable and customize your chart in 3D.

The chart area minimum and maximum will not be automatically recalculated if you add new data, so the chart will not automatically change axis sizes. You can require the chart area to recalculate these values by using the RecalculateAxesScale method.

To align multiple chart areas vertically, set the AlignmentOrientation property. To align multiple chart areas horizontally, you must first position the chart areas using the Position property, and then set the AlignmentOrientation property to Horizontal.

To suppress the display of a series, set the Series property of that series to a zero-length string.

Constructors

ChartArea() ChartArea() ChartArea() ChartArea()

Initializes a new instance of the ChartArea class.

ChartArea(String) ChartArea(String) ChartArea(String) ChartArea(String)

Initializes a new instance of the ChartArea class with the specified chart area name.

Properties

AlignmentOrientation AlignmentOrientation AlignmentOrientation AlignmentOrientation

Gets or sets the alignment orientation of a chart area.

AlignmentStyle AlignmentStyle AlignmentStyle AlignmentStyle

Gets or sets the alignment style of the ChartArea.

AlignWithChartArea AlignWithChartArea AlignWithChartArea AlignWithChartArea

Gets or sets the name of the ChartArea object to which this chart area should be aligned.

Area3DStyle Area3DStyle Area3DStyle Area3DStyle

Gets or sets a ChartArea3DStyle object, which is used to implement three-dimensional (3D) for all series in a chart area.

Axes Axes Axes Axes

Gets or sets an array that represents all axes for a chart area.

AxisX AxisX AxisX AxisX

Gets or sets an Axis object that represents the primary X-axis.

AxisX2 AxisX2 AxisX2 AxisX2

Gets or sets an Axis object that represents the secondary X-axis.

AxisY AxisY AxisY AxisY

Gets or sets an Axis object that represents the primary Y-axis.

AxisY2 AxisY2 AxisY2 AxisY2

Gets or sets an Axis object that represents the secondary Y-axis.

BackColor BackColor BackColor BackColor

Gets or sets the background color of a ChartArea object.

BackGradientStyle BackGradientStyle BackGradientStyle BackGradientStyle

Gets or sets the orientation for the background gradient of a chart area, and also determines whether or not a gradient is used.

BackHatchStyle BackHatchStyle BackHatchStyle BackHatchStyle

Gets or sets the hatching style of a ChartArea object.

BackImage BackImage BackImage BackImage

Gets or sets the background image of a ChartArea object.

BackImageAlignment BackImageAlignment BackImageAlignment BackImageAlignment

Gets or sets the alignment of a ChartArea background image.

BackImageTransparentColor BackImageTransparentColor BackImageTransparentColor BackImageTransparentColor

Gets or sets the color of a ChartArea object background image that will be drawn as transparent.

BackImageWrapMode BackImageWrapMode BackImageWrapMode BackImageWrapMode

Gets or sets the drawing mode for the background image of a ChartArea object.

BackSecondaryColor BackSecondaryColor BackSecondaryColor BackSecondaryColor

Gets or sets the secondary color for the background of a ChartArea object.

BorderColor BorderColor BorderColor BorderColor

Gets or sets the border color of a ChartArea object.

BorderDashStyle BorderDashStyle BorderDashStyle BorderDashStyle

Gets or sets the border style of a ChartArea object.

BorderWidth BorderWidth BorderWidth BorderWidth

Gets or sets the border width of a ChartArea object.

CursorX CursorX CursorX CursorX

Gets or sets a Cursor object that is used for cursors and selected ranges along the X-axis.

CursorY CursorY CursorY CursorY

Gets or sets a Cursor object that is used for cursors and selected ranges along the Y-axis.

InnerPlotPosition InnerPlotPosition InnerPlotPosition InnerPlotPosition

Gets or sets an ElementPosition object, which defines the inner plot position of a chart area object.

IsSameFontSizeForAllAxes IsSameFontSizeForAllAxes IsSameFontSizeForAllAxes IsSameFontSizeForAllAxes

Gets or sets a flag that determines if the labels of the relevant chart area axes are of equal size.

Name Name Name Name

Gets or sets the unique name of a ChartArea object.

Position Position Position Position

Gets or sets an ElementPosition object that defines the position of a ChartArea object within the Chart.

ShadowColor ShadowColor ShadowColor ShadowColor

Gets or sets the shadow color of a ChartArea object.

ShadowOffset ShadowOffset ShadowOffset ShadowOffset

Gets or sets the shadow offset, in pixels, of a ChartArea object.

Tag Tag Tag Tag

Gets or sets an object associated with this chart element.

(Inherited from ChartElement)
Visible Visible Visible Visible

Gets or sets a flag that determines if a chart area is visible.

Methods

Dispose() Dispose() Dispose() Dispose()

Releases the resources used by the ChartElement.

(Inherited from ChartElement)
Dispose(Boolean) Dispose(Boolean) Dispose(Boolean) Dispose(Boolean)

Releases unmanaged and, optionally, managed resources.

Equals(Object) Equals(Object) Equals(Object) Equals(Object)

Determines whether the specified Object is equal to the current ChartElement.

(Inherited from ChartElement)
GetHashCode() GetHashCode() GetHashCode() GetHashCode()

Returns a hash function for a particular type.

(Inherited from ChartElement)
GetSeriesDepth(Series) GetSeriesDepth(Series) GetSeriesDepth(Series) GetSeriesDepth(Series)

Returns the depth of a Series in a chart area.

GetSeriesZPosition(Series) GetSeriesZPosition(Series) GetSeriesZPosition(Series) GetSeriesZPosition(Series)

Returns the Z position of a series, which is useful for custom drawing.

GetType() GetType() GetType() GetType()

Gets the Type of the current instance.

(Inherited from Object)
MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

Creates a shallow copy of the current Object.

(Inherited from Object)
RecalculateAxesScale() RecalculateAxesScale() RecalculateAxesScale() RecalculateAxesScale()

Recalculates the properties of the chart area after changes have been made to the chart in the Customize event.

ToString() ToString() ToString() ToString()

Returns a string that represents the current Object.

(Inherited from ChartElement)
TransformPoints(Point3D[]) TransformPoints(Point3D[]) TransformPoints(Point3D[]) TransformPoints(Point3D[])

Applies 3D transformations to an array of 3D points, which must be done before GDI+ drawing methods can be called.

Applies to