新手入门

---

点击立即下载最新版TeeChart for .NET

加入官方社群740060302，欢迎相互交流

介绍

基本图表可以使用TeeChart编辑器构建和实现，很少或根本不使用代码。TeeChart编辑器是两个编辑器合一，因为图表可以被认为是不同于它的数据系列内容。用户可以定义图表外观、标题、图例特征和3D方面，而不必包含数据系列。这使用户可以在运行时自由地添加和删除不同的数据系列类型，而不必重新定义整个图表的外观。

这些组件一起运行，图表轴是图表和系列之间的接口。系列具有数据，其值将影响图表轴的标签特征。在添加数据系列之前，可以为图表定义轴外观、颜色、网格频率和标签字体。TeeChart将对大多数值进行最佳估计，以最大限度地减少用户预定义图表和系列属性的需要。

使用图表编辑器添加多个系列类型:TeeChart的“不同于系列的图表”设计范例允许用户混合各种系列类型，而不限于选择预定义的图表格式。

TeeChart Pro .Net与ASP. NET完全兼容，能够放置在一个ASP. NET WebForm，并在设计时以完全所见即所得的方式进行编辑。您可以选择在运行时从可用列表中输出的图像格式类型:JPEG, GIF, PNG, TIFF, BMP和EMF。有关更多信息，请参阅Internet应用程序教程。

本教程中的步骤强调了从头开始构建图表是简单的，并将向您介绍TeeChart编辑器，使您能够通过后面的教程修改和进一步增强图表的外观和功能。

建立图表

包括在WinForm上使用TeeChart

通过使用TeeChart的安装程序，用户将成功地将TeeChart图标添加到Visual Studio .Net 编程环境的工具箱中。

TeeChart图标是圆形(饼状)图表的表示形式。

选择“工具栏”中的图标，单击并拖动到窗体上的图表大小。您将看到TeeChart作为一个面板，具有一些基本的图表功能，如轴和标题。TeeChart当然不仅仅是一个小组;右键单击新的TeeChart，你会看到一个菜单显示。选择编辑…选项来访问TeeChart编辑器。

有关TeeChart的其他调色板组件的介绍，请点击本教程该篇文章的链接。

TeeChart编辑器

TeeChart编辑器可以访问最常用的图表属性。

要添加新系列，请单击添加…按钮，并从“系列图库”中选择“系列”类型。如果在现在选择了一个Series类型之后，您希望稍后更改它，您可以通过返回到第一个Editor屏幕并选择Change…按钮。

TeeChart系列图库

该系列图库由八个标签页组成:

• Standard——标准系列类型，那些可能被最频繁调用的类型，如线条，条形，饼形等。
• Extended——扩展系列类型，包括用于规划或地图应用的更专业的系列类型，例如Arrow, Polar，组织结构图，Bezier等。
• Financial——金融系列包括用于金融应用的更专业的金融系列类型。
• Other——如果你还没有找到你想要的图表类型，你可能会在这里找到它，例如Tag Cloud, Wind Rose, Calendar, 等。
• 3D——3D系列包括提供三维表示的系列类型，例如表面，瀑布，塔等。这些类型采用三个(X, Y, Z)而不是两个(X, Y)变量。
• Stats——统计系列包括统计应用程序的图表系列类型，例如直方图，误差条，箱线图等。
• Gauges——量规系列提供多种量规，如数字，线性，圆形等。
• Maps——地图系列包括世界、欧洲、北美、亚洲等不同地理分布图。

选择“系列”类型。对于这个练习，我们将选择Bar Series类型。图库将关闭，新系列将显示在第一个图表编辑器屏幕中。

填充新的数据系列

在“图表编辑器”中选择“系列”选项卡以显示“系列”配置属性。Series页面上的第四个选项卡是数据源选项卡。

ADO. NET

如果您的数据源是ADO。那么你可以直接在图表编辑器中映射你的数据。

在本例中，我们将把BarSeries连接到TeeChart。mdb Access数据库。首先，从VS.NET工具箱的Data选项卡中，将一个OleDbDataAdapter拖到一个带有。net对象的WinForm上。在数据适配器配置向导上单击“下一步”，然后在下一页单击“新建连接…”按钮。现在点击新窗口的“Provider”选项卡，选择“Microsoft Jet OLE DB Provider”，如下图所示:

(*请注意——不同框架之间向导程序的外观略有不同)

现在点击同一窗口的“Connection”选项卡，选择TeeChart。TeeChart for .Net根目录下的Sample Data文件夹中的mdb文件:

单击“Test Connection”按钮测试连接，然后单击同一窗口的“OK”按钮。现在单击Data Adapter Configuration Wizard窗口的“Next”按钮，在出现的窗口中选择“Use SQL Statements”，然后再次单击“Next”按钮。现在单击“Query Builder”按钮并添加“Employee”表。关闭“Add Table”窗口，然后选择“*(All Columns)”复选框:

现在确定这个窗口，点击“下一步”，然后点击“Finish。现在打开TeeChart编辑器，添加BarSeries并导航到Series选项卡的DataSource选项卡。从组合框中选择“Database”，oleDbDataAdapter1 [System.Data.OleDb. OleDbDataAdapter]从数据集组合框。设置标签为“LASTNAME”，Y为“SALARY”，如下图所示:

现在单击Apply按钮并运行表单;现在，您应该拥有如下内容:

有关更多信息，请参阅ADO. NET Database Access.

编码数据输入

对于程序化的数据输入，你需要编写一些代码。本节将向您展示使用编码输入构建图表所需的步骤。

您之前使用图表编辑器添加的系列在设计时显示随机数据。但是，在运行时，除非您手动填充，否则该系列将为空。从工具箱中选择一个按钮并将其放置在窗体上。在Visual Studio . net中，双击Button以访问代码编辑器(方法在不同的编程环境中可能有所不同)。

在代码编辑器中输入这些行的内容:

[C#.Net]
private void button1_Click(object sender, System.EventArgs e)
{
bar1.Add(3,"Pears",Color.Red);
bar1.Add(4,"Apples",Color.Blue);
bar1.Add(2,"Oranges",Color.Green);
}

[VB.Net]
Private Sub Button1_Click(ByVal sender As System.Object, ByVal e As System.EventArgs) Handles Button1.Click
Bar1.Add(3, "Pears", Color.Red)
Bar1.Add(4, "Apples", Color.Blue)
Bar1.Add(2, "Oranges", Color.Green)
End Sub

运行项目并按下按钮。三个新的Bar将出现在图表上

图表中的第一个柱状序列称为Bar1，第二个柱状序列称为Bar2，依此类推。因此，在图表中有多个系列时，您可以使用这些名称来修改相关系列。

系列的添加方法有25个重载，其中第7个接受3个变量，值，文本和颜色。因此，添加方法假定Label轴(在本例中为x轴)上的值间距相等。如果你的数据包含两个变量，你可以使用另一个Add方法的重载。将另一个Button添加到项目中，并将此代码放入其中。运行项目并使用以下代码添加点:

[C#.Net]
private void button2_Click(object sender, System.EventArgs e)
{
Random rnd = new Random();
if(bar1.Count > 0)
{
//Increment X Axis value and add a new random point
bar1.Add((bar1.XValues.Last + rnd.Next(10)), ((bar1.YValues.Last/(bar1.YValues.Last - 1)) + rnd.Next(10)),"Lemons",Color.Yellow);
}
else
{
//Add a new random point
bar1.Add(1,rnd.Next(10),"Lemons",Color.Yellow);
}
}

[VB.Net]
Private Sub Button2_Click(ByVal sender As System.Object, ByVal e As System.EventArgs) Handles Button2.Click
Dim rnd As Random
If (Bar1.Count > 0) Then
'Increment X Axis value and add a new random point
Bar1.Add((Bar1.XValues.Last + rnd.Next(10)), ((Bar1.YValues.Last / (Bar1.YValues.Last - 1)) + rnd.Next(10)), "Lemons", Color.Yellow)
Else
'Add a new random point
Bar1.Add(1, rnd.Next(10), "Lemons", Color.Yellow)
End If
End Sub

选择系列类型以满足您的需求

最后一个代码示例生成了新的X和Y值。点之间的X轴距离不是恒定的，在某些情况下会导致bar重叠，这对于某些应用来说是可取的，但并非所有应用都是如此。使用图表编辑器更改系列类型(在设计时进入图表编辑器并使用第一页上的Change按钮，然后将代码中对Bar1的所有引用更改为Line1)为LineSeries显示了用2个变量图形化表示数据的另一种方法。

如果数据包含2个以上变量，则有适合显示数据的其他系列类型。查看图表库，选择您认为最适合您的系列类型，然后在TeeChart教程中阅读相关信息。