ChartArea 类

定义

命名空间:

System.Windows.Forms.DataVisualization.Charting

程序集:

System.Windows.Forms.DataVisualization.dll

表示图表图像上的图表区域。

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

继承

Object

ChartElement

ChartNamedElement

ChartArea

注解

在任何给定图表中， 内部绘图位置 是 x 轴和 y 轴线内的矩形区域，其中绘制了数据点。 绘图位置是包含内部绘图位置、刻度线和轴标签的矩形区域。 图表区是包含图表上绘图位置、刻度线、轴标签和轴标题的矩形区域。

图表区由 ChartArea 类表示; ChartArea 对象存储在 类中 ChartAreaCollection 。

可在图表区中绘制的图表系列数量不受限制。

对象 ChartArea ：

• 使用一个不同的内部绘图区域。

• 用于绘制一个或多个图表系列。

• 除饼图和圆环图类型外，具有主轴和辅助 x 轴和 y 轴。

使用形状图表类型（包括饼图、圆环图、漏斗图、棱锥图、极坐标图和雷达图）时，内部绘图位置定义图表类型形状的大小。 例如，增加饼图上 属性的值 InnerPlotPosition 时，将增加饼图的半径。

对于所有其他图表类型，每个图表区都有两组 X 轴和 Y 轴：主要轴和次要轴。 若要访问与这些轴相关的属性，请使用 AxisX、 AxisX2AxisY 和 AxisY2 属性。 如果需要设置影响图表上所有轴的属性，请使用 Axes 属性。

一个或多个系列与图表区相关联。 序列具有一个 ChartArea 属性，该属性确定每个系列所属的图表区域。 默认情况下，序列连接到默认图表区。 若要禁用序列的显示，请将该系列的 属性设置为 ChartArea 零长度字符串。

如果向图表添加了另一个图表区，则可以将任何序列与新的图表区相关联。 在所有形状图表类型以及条形图和堆积条形图类型中，每个系列都必须绘制在单独的图表区中。 在所有其他图表类型中，多个序列可以组合在同一个图表区域中。

三维图表以图表面积为基础显示。 可以使用 Area3DStyle 属性在 3D 中启用和自定义图表。

如果添加新数据，图表区域的最小值和最大值不会自动重新计算，因此图表不会自动更改轴大小。 可以使用 方法要求图表区重新计算这些值 RecalculateAxesScale 。

若要垂直对齐多个图表区域，请 AlignmentOrientation 设置 属性。 若要水平对齐多个图表区域，必须先使用 Position 属性定位图表区域，然后将属性 AlignmentOrientation 设置为 Horizontal。

若要禁止显示序列，请将该系列的 属性设置为 Series 长度为零的字符串。

构造函数

ChartArea()	初始化 ChartArea 类的新实例。
ChartArea(String)	用指定的图表区域名称初始化 ChartArea 类的新实例。

属性

AlignmentOrientation	获取或设置图表区域的对齐方向。
AlignmentStyle	获取或设置 ChartArea 的对齐样式。
AlignWithChartArea	获取或设置此图表区域应与之对齐的 ChartArea 对象的名称。
Area3DStyle	获取或设置 ChartArea3DStyle 对象，该对象用于实现图表区域中所有序列的三维 (3D)。
Axes	获取或设置表示图表区域中所有轴的数组。
AxisX	获取或设置表示主 X 轴的 Axis 对象。
AxisX2	获取或设置表示辅助 X 轴的 Axis 对象。
AxisY	获取或设置表示主 Y 轴的 Axis 对象。
AxisY2	获取或设置表示辅助 Y 轴的 Axis 对象。
BackColor	获取或设置 ChartArea 对象的背景色。
BackGradientStyle	获取或设置图表区域的背景渐变方向，还确定是否使用渐变。
BackHatchStyle	获取或设置 ChartArea 对象的阴影样式。
BackImage	获取或设置 ChartArea 对象的背景图像。
BackImageAlignment	获取或设置 ChartArea 背景图像的对齐方式。
BackImageTransparentColor	获取或设置 ChartArea 对象背景图像的颜色，该背景图像将以透明色绘制。
BackImageWrapMode	获取或设置 ChartArea 对象背景图像的绘制模式。
BackSecondaryColor	获取或设置 ChartArea 对象背景的辅助颜色。
BorderColor	获取或设置 ChartArea 对象的边框颜色。
BorderDashStyle	获取或设置 ChartArea 对象的边框样式。
BorderWidth	获取或设置 ChartArea 对象的边框宽度。
CursorX	获取或设置一个 Cursor 对象，该对象用于沿 X 轴的光标和所选范围。
CursorY	获取或设置一个 Cursor 对象，该对象用于沿 Y 轴的光标和所选范围。
InnerPlotPosition	获取或设置 ElementPosition 对象，该对象定义图表区域对象的内部绘图位置。
IsSameFontSizeForAllAxes	获取或设置一个标志，该标志确定相关图表区域轴的标签大小是否相等。
Name	获取或设置 ChartArea 对象的唯一名称。
Position	获取或设置一个 ElementPosition 对象，该对象定义 ChartArea 对象在 Chart 内的位置。
ShadowColor	获取或设置 ChartArea 对象的阴影颜色。
ShadowOffset	获取或设置 ChartArea 对象的阴影偏移量（以像素为单位）。
Tag	获取或设置与此图表元素关联的对象。 (继承自 ChartElement)
Visible	获取或设置用于确定图表区域是否可见的标志。

方法

Dispose()	释放由 ChartElement 占用的资源。 (继承自 ChartElement)
Dispose(Boolean)	释放非托管资源和（可选）托管资源。
Equals(Object)	确定指定的 Object 是否等同于当前的 ChartElement。 (继承自 ChartElement)
GetHashCode()	返回特定类型的哈希算法。 (继承自 ChartElement)
GetSeriesDepth(Series)	返回图表区域中 Series 的深度。
GetSeriesZPosition(Series)	返回序列的 Z 位置，它对自定义绘图非常有用。
GetType()	获取当前实例的 Type。 (继承自 Object)
MemberwiseClone()	创建当前 Object 的浅表副本。 (继承自 Object)
RecalculateAxesScale()	在 Customize 事件中对图表进行更改之后，重新计算图表区域的属性。
ToString()	返回表示当前 Object 的字符串。 (继承自 ChartElement)
TransformPoints(Point3D[])	将三维变换应用于一个三维点数组，必须完成该应用才能调用 GDI+ 绘图方法。