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

article/2025/10/21 7:39:23

DotNetBar for WinForms是一个拥有89个组件的用户界面控件套包，用户可以使用Visual Studio 2005-2015轻松地创建专业的用户界面。十多年来DotNetBar帮助开发人员轻松地创建易用的专业Windows Forms (WinForms) 用户界面。DotNetBar是全世界第一个引入全功能Office 2013、Office 2010、Windows 7、 Office 2007 style Ribbon控件以及Visual Studio 2005-2013，Metro等主题风格和样式的控件。

点击下载新版DotNetBar for WinForms

架构概述

(注意：本文档中介绍的许多ChartControl的选项和功能，在DotNetBar Samples文件夹中的ChartControl Demo Applications中都有演示。请参考它作为一个额外的信息和帮助的来源。）

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

（此体系结构中包含的项目将在本文档的后面部分进行详细说明）。

组件概述

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

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

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

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

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

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

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

显示1a

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

ChartElements2

图表控件

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调用。