本文档介绍了在 XtraReports 中使用 XRChart 控件的要点,并描述了它的主要功能。
在本文档中包含下列小节。
图表概述
XRChart 控件复制了 ChartControl 的所有普通功能,被设计用于通过图表在 XtraReports 中呈现多种数据。 它把 点系列 显示为 二维图表类型 或 三维图表类型。 通过系列的 View 属性指定图表类型。 同时,如果多个系列的 视图类型 是 兼容的,那么可以在单个图表中进行显示。
注意 |
---|
只能在 XtraReports 中使用 XRChart 控件。 要把图表添加到 Windows (R) 窗体和 ASP.NET 应用程序,就应使用 ChartControl 和 WebChartControl 控件,这两个控件属于 XtraCharts 套件,应该另外购买。 |
下面的插图展示了一个三维饼图。
图表包含多个 可视化元素 (图像、坐标轴、标题、标签、数值带、常数线等),在设计时刻可以选择这些元素 (因为它们不是 Component 的子类)。 并且,当这些元素的任一个被选中时,它的属性就被显示在 属性网格 中。
要为图表提供数据,首先需要创建一个数据源 (实际了 IList、IListSource 或 IBindingList 接口的任意对象),并指派到 XRChart.DataSource 属性。 同时,如果需要由图表控件自动填充数据源 (设计时刻和运行时刻),就要指定 XRChart.DataAdapter 属性。 否则就需要人工填充。
然后,执行下列操作之一。
-
分别绑定 每个系列。
要这样做,则创建一个或几个系列,并且添加到图表的 XRChart.Series 集合中。 然后,指定哪些数据字段被用作点参数 (SeriesBase.ArgumentDataMember),以及哪些数据字段被用作点值 (SeriesBase.ValueDataMembers)。
-
把 整个图表 绑定到数据。
当系列名称被分别存储在数据源中时,这种数据绑定方法是有用的,那样所有系列都可以被自动生成。 要使用这种绑定方法,则把包含系列名称的数据字段指派到 XRChart.SeriesDataMember 属性。 然后,把用作系列点参数和取值的数据字段分别指定到 SeriesBase.ArgumentDataMember 和 SeriesBase.ValueDataMembers 属性 (它们是 SeriesBase 对象的成员,此对象由 XRChart.SeriesTemplate 属性返回)。
注意,应该保持 SeriesBase.ArgumentScaleType 和 SeriesBase.ValueScaleType 属性数据的兼容性。
要学习更多关于使用图表的内容,请参阅 XtraCharts 帮助文档。
透视图表
XRPivotGrid 控件是图表的 一种常见数据源,意思是确实可以把透视网格的对象实例指派到图表的 XRChart.DataSource 属性,那样所有数据和布局设置都被自动定义。
可以通过 XRChart.PivotGridDataSourceOptions 属性来访问这些设置。
要学习更多相关内容,请参阅 透视图表 (与透视网格控件集成)。