本文档详细说明了在 XtraCharts 中 图象 的使用： 它的目标、实现和功能。 在阅读本文档之前，回顾 XtraCharts 的基本概念可能是有用的，在下列文档中说明了这些概念： 图表基础。
本文档由下列小节组成。
图象概述
图象 是最基本的图表元素之一，相同级别的图表元素是 系列、图表标题 和 图例。 在结构上，图象是图表的 窗格 和 轴 的父容器，并且在视觉上，图象也装入了图表的系列。 且不管系列并不真正属于 Diagram 对象这一事实 (而是，系列位于 ChartControl 的 SeriesCollection 集合中)，系列刚性地互相依赖于图象的类型 (本文档的后续部分详细说明了这一点)，并且在视觉上被显示在图象的边界之内。 要查看 XtraCharts 体系结构图，请参阅 图表元素。
注意，每个图表只可能有 一个 图象对象。 但是，在相同的图象 ( 二维 XY-图象 类型) 中，可以绘制多个 窗格，如同上面的插图所显示的那样。 要获知细节，请参阅 窗格概述。
图象最重要的特征是 图象类型。 图象类型取决于图表系列的 视图类型。 在默认情况下，根据图表的集合中的 第一个可视系列 的视图类型，自动确定图表的图象类型。 注意，Diagram 对象等于 null (在 Visual Basic 中为 Nothing)，直到图表的集合中 至少有一个系列。
因此，每种类型的图象只能显示对应视图类型的系列。 并且，在同一个 Diagram 对象内部 (也因此在同一个图表内部)，不可能绘制多个不兼容视图类型的系列。 要学习更多相关内容，请参阅 组合使用不同的系列视图。
另外，每种图象类型都有一组独特的可用选项和元素。
在下面的列表中，可用的图象类型被划分为几种基本类别。 关于每种图象类型的特性的详细说明，请参阅对应的文档。
要访问几乎任意图表元素 (除去 系列、标题 和 图例 之外)，首先应该访问图象本身。 在本文档的下一小节中，简要说明了如何在设计时刻和运行时刻完成此任务： 访问图象。
访问图象
要在设计时刻访问图象，则单击图表控件来选中它。 然后，在 属性 窗口中找到 ChartControl.Diagram 属性并展开它。 您将能看到对于这种图象类型的可用属性列表。 注意，这些属性组依赖于图象的类型。
在运行时刻，通过 Diagram 类的实例来表示图象，可以通过 ChartControl.Diagram 属性来访问它。 要访问图象的元素和属性，则应该把图象的实例转换为特定的图象类型，如同下面的示例所展示的那样。
| C# |  复制代码 |
|---|---|
// Create a new ChartControl instance. ChartControl chartControl1= new ChartControl(); // Create a series of a compatible view type, // and add it to the chart's collection, // so the diagram object shall not to be equal to null. Series series1 = new Series("Line Series 1", ViewType.Line); chart.Series.Add(series1); // Access the chart's diagram properties, e.g. rotate the diagram. ((XYDiagram)chartControl1.Diagram).Rotated = true; // Access properties of objects that belong to the diagram, e.g. axes and panes. ((XYDiagram)chartControl1.Diagram).AxisX.Color = Color.Red; ((XYDiagram)chartControl1.Diagram).Panes[0].BackColor = Color.Black; | |
| Visual Basic | 复制代码 |
|---|---|
' Create a new ChartControl instance. Dim chartControl1 As New ChartControl() ' Create a series of a compatible view type, ' and add it to the chart's collection, ' so the diagram object shall not to be equal to Nothing. Dim series1 As New Series("Line Series 1", ViewType.Line) chart.Series.Add(series1) ' Access the chart's diagram properties, e.g. rotate the diagram. CType(chartControl1.Diagram, XYDiagram).Rotated = True ' Access properties of objects that belong to the diagram, e.g. axes and panes. CType(chartControl1.Diagram, XYDiagram).AxisX.Color = Color.Red CType(chartControl1.Diagram, XYDiagram).Panes(0).BackColor = Color.Black | |
注意，如果把图象对象转换为不恰当的图象类型 (例如有不兼容的系列)，就会抛出一个异常。
