DotNetBar for WinForms使用教程：图表控件用户指南（一）

架构概述

以下是ChartControl的体系结构的基本概述。

组件概述

下面的图片说明了ChartControl中的主要组件。

在第一张图中，我们有4个独立的图表，每个图表占用一个2×2定义矩阵的单个单元格（见ChartMatrix）。 每个矩阵单元格（或单元格范围）可以包含一个或多个ChartContainer项。 ChartContainer项可以是一个ChartPanel或一个ChartXy元素。

ChartPanel元素可以包含额外的ChartPanel或ChartXy元素，或以它们自己的矩阵布局为导向。

ChartXy元素可以包含任意数量的ChartSeries（以及它们相关的ChartAxes，DataLabels等）。

每个ChartSeries可以是基于点、线或气泡的系列，并且可以与主要的、默认的轴相关联，或者与任何数量的用户定义和创建的辅助轴相关联。

每个ChartPanel、ChartXy和ChartAxis可以有多个定义的Titles，并根据应用程序的需要进行定向和样式设计。

下面是一些示例的ChartControl图表。

下一个图表控件说明了其他图表组件，例如图表图例，数据标签，参考线，趋势线，回归线和轴条纹。这些项目中的每一项都是高度可配置的（例如，带有阴影，前景色和背景色，方向/对齐方式，可见性，值格式等）。

图表控件

ChartControl主对象包含了与整个控件相关的属性和方法。下面是这些属性和方法的列表和说明。

图表控件属性

ChartCursor – 获取或设置ChartControl的 “逻辑 “游标。使用 “Cursor “属性为应用程序设置默认的Cursor。ChartCursor用于设置基于与系统鼠标交互的底层图表元素的Cursor。

ChartPanel – 获取ChartControl的主要（或默认）ChartPanel。这是所有定义的图表项的根容器元素。每个ChartPanel管理一个ChartContainer项的矩阵（ChartPanel或ChartXy项）。 ChartPanel可以根据应用程序的需要嵌套到任何深度。它们可以选择滚动（通过水平和垂直滚动条）或 “平移”（通过点击和拖动ChartPanel的内容）。滚动和平移在ChartXy和ChartLegend项目中也是可用的。

DataMember – 获取或设置应用程序定义的默认的 “DataMember”（通过设置DataSource关联和定义）。在ChartControl级别上设置DataMember，可以使其在整个ChartControl中使用（如果需要的话，每个ChartPanel、ChartXy和ChartSeries可以有自己的DataSource和DataMember集）。

DataSource – 获取或设置应用程序定义的默认 “DataSource”。 在ChartControl级别设置DataSource，将使其在整个ChartControl中得到使用（如果需要的话，每个ChartPanel、ChartXy和ChartSeries可以有自己的DataSource和DataMember集）。

DefaultVisualStyles – 获取或设置整个ChartControl的默认视觉样式。ChartControl中的每个元素（ChartPanel、ChartXy、ChartSeries、ChartAxis等）都可以设置他们自己的特定样式，并且在这样做的时候，会覆盖控件范围内的设置。

IsUpdateSuspended – 获取当前的可视化更新机制是否已经暂停。可以通过调用BeginUpdate()暂停更新，并通过调用EndUpdate()重新启动更新。Begin/EndUpdate()必须作为一对调用（可以调用多个BeginUpdates()，但最终必须与一个匹配的EndUpdate()调用配对）。

IsUpdateSuspended – 获取当前 “选定的 “ChartControl项的列表。

SelectedItems – 获取当前标记为 “Selected “的项的列表。

图表控件方法

UpdateLayout([bool force])

这个例程执行ChartControl的布局和安排。 如果需要的话，您应该很少调用这个函数。ChartControl在任何图表属性发生变化后都会使用这个例程，这些变化需要重新计算布局并安排其元素。 它被提供给外部使用，以便在图表内部执行此操作之前，您可能需要了解布局信息。

PaintTo(Graphics g [,Rectangle ClipRectangle])

该例程将ChartControl绘制到给定的图形画布上。 它可以用来将图表保存为图像，以便以后显示/使用，或者提供您自己的专门打印操作，或者一些类似的功能。注意，打印支持由图表本身提供）。

GetElementAt(Point pt)

这个例程获取位于给定点的图表控制元素。 请注意，该点需要用控件的局部坐标，而不是屏幕坐标。

BeginUpdate()
EndUpdate()

调用BeginUpdate例程会通知ChartControl一个扩展更新阶段已经开始，该控件将暂停所有布局计算和显示更新，直到相应的EndUpdate例程被调用。您可能永远都不需要暂停输出，但是这个功能还是提供了。

BeginUpdate / EndUpdate可以嵌套，并且必须成对调用–每个BeginUpdate必须有一个匹配的EndUpdate调用。

GetSelected(ChartContainer item)

这个例程返回给定项目是否被选中。

SetSelected(ChartContainer item, bool selected)

这个例程设置或清除给定项目的选择状态。

ClearAllSelected()

这个例程可以清除每个选择项的选择状态。

未完待续………………

标签：