【TeeChart for Java教程】（一）构建图表并填充数据系列

【下载TeeChart for Java最新版本】

本教程中的步骤强调了从头开始构建图表是多么容易，并将向您介绍图表编辑器，使您能够通过以后的教程在运行时修改并进一步增强图表的外观和功能。

（一）简介

您可以定义图表外观，标题，图例特征和3D方面，而无需包含数据系列，可以自由地在运行时添加和删除不同的数据系列类型，而无需重新定义整个图表的外观。

所有东西都汇集在一起​​制作最终的Chart，Chart轴是Chart和Series之间的接口。Series具有数据，其值将影响Chart轴的标签特征。在添加数据系列之前，可以为图表定义轴外观，颜色，网格频率和标签字体。TeeChart将对大多数值进行最佳估计，以最大限度地减少您手动定义图表和系列方法的需要。

（二）建立图表

2.1 在表格上包括TeeChart

按照TeeChart的安装说明，您应该已成功将TeeChart Pro图标添加到Java Component调色板。TeeChart图标表示带圆圈的（饼图）图表。您可以在Java Component Palette 的Additional部分找到TeeChart，即TChart组件。选择三个中的第一个图标，然后单击并拖出以在表单上调整TChart的大小。 您将看到TChart作为一个面板，其中包含一些基本的图表功能，如Axis和Title。

2.2 填充新数据系列

对于编程的数据输入，您需要编写一些代码。本节将向您展示使用编码输入构建图表所需的步骤，在运行时，除非您手动填充数据，否则系列将没有数据。从“Component”选项板中选择“Command”按钮，然后将其放在“Form”上。双击按钮以访问代码编辑器，在代码编辑器中键入以下行：

Series bar = new Bar(tChart1.getChart());
tChart1.getAxes().getBottom().setIncrement(1);
bar.add(400, "pears", Color.Green);
bar.add(500, "apples", Color.Red);
bar.add(400, "bananas", Color.Yellow);
bar.add(200, "oranges", Color.Orange);

运行项目并按下命令按钮，您的图表上将显示三个新栏，没有更多的东西了。 Series'Add方法接受3个变量，Value，Label和Color。因此，Add方法假设Label轴上的值间隔相等（在本例中为X轴）。如果您的数据包含2个变量，则可以使用AddXY方法。向项目添加另一个Command按钮并将此代码放入其中，运行项目并添加以下代码：

Random rnd = new Random();

Series bar = new Bar(tChart1.getChart());

	if (bar.getCount() > 0)
	{
	// Increment X Axis value and add a new random point 
		bar.add((bar.getXValues().getLast() + rnd.nextInt(10)), 
			((bar.getYValues().getLast() / (bar.getYValues().getLast() - 1.0)) + 
			rnd.nextInt(10)), "Lemons", Color.GreenYellow); 
	}
	else
	{
		// Add a new random point
		bar.add(1, rnd.nextInt(10), "Lemons", Color.Yellow);
	} 

（三）图表编辑器

3.1 在运行时访问图表编辑器

要访问图表编辑器，请选择一个命令按钮并将其放在表单上，双击它并添加以下代码行。

ChartEditor.editChart(tChart2.getChart());

运行项目并单击按钮以查看图表编辑器，图表编辑器允许您在运行时访问大多数常用的图表属性。

要添加新系列，请单击“ Add...”按钮，然后从“Series Gallery”中选择“Series”类型，如果在选择系列类型之后您希望稍后更改它（通过返回第一个编辑器屏幕并选择Change..按钮，可能会出现一些例外，其中系列数据内容可能不兼容）。

3.2 图表系列图库

该图库包含六个标签页：

• Standard （标准）
  标准系列类型：最常被调用的类型。
• Extended （扩展）
  扩展系列类型，包括用于规划或映射的更专业的系列类型应用程序，例如Arrow，Polar，Org Charts，Bezier等。
• Financial （财务）
  金融系列包括更专业的财务系列金融系列类型。
• Other （其他）
  如果用户还没有找到寻找的图表类型，可能会在这里找到它，例如Tag Cloud，Wind Rose，Calendar等
• 3D 
  3D Series包括提供三维表示的系列类型，例如Surface ，瀑布，塔等。这些类型采用三个（X，Y，Z）而不是两个（X，Y）变量。
• Stats （统计）
  统计系列包括图表系列类型统计应用，例如直方图，误差线，箱线图，等

（四）选择系列类型以满足用户的数据需求

最后一个编码示例生成了新的X和Y值，点之间的X轴距离可能不是恒定的，这取决于所使用的值，在某些情况下可能导致条形图重叠。这对于一些但不是所有应用都是可取的，使用图表编辑器更改系列类型（在设计时输入图表编辑器并使用第一页上的“ Change”按钮）到LineSeries，显示另一种以2个变量以图形方式表示数据的方法。如果您的数据包含2个以上的变量，则还有其他适合显示数据的系列类型。下表显示了TeeChart系列类型的组成。

系列类型	变量数量	数据源属性
标准类型
Line	2	XValues，YValues，XLabel
Horizontal Line	2	XValues，YValues，XLabel
Fast Line	2	XValues，YValues，XLabel
Bar	2	XValues, YValues (called Bar), XLabel
HorizBar	2	XValues, YValues (called Bar), XLabel
Area	2	XValues, YValues, XLabel
HorizArea	2	XValues, YValues, XLabel
Point	2	XValues, YValues, XLabel
Pie	1	PieValues, XLabel
Arrow	4	StartXValues, StartYValues, XLabel, EndXValues, EndYValues
Bubble	3	Xvalues, YValues, XLabel, RadiusValues
Gantt	3	StartValues，EndValues，AY（Y轴级别），AXLabel（标签可选择显示在Y轴上或作为标记）
Shape	4	X0 (Top), Y0 (Bottom), X1 (Left), Y1 (Right)
扩展类型的子集
Bezier	2	XValues, YValues, XLabel
Candle	5	OpenValues, CloseValues, HighValues, LowValues, DateValues
Contour	3	XValues, YValues, XLabel, ZValues
Error Bar	3	XValues, YValues, XLabel, ErrorValues
Point3D	3	XValues, YValues, XLabel, ZValues
Polar	2	XValues，YValues，Labels（Polar有角度和半径）
Radar	2	XValues，YValues，Labels（Radar具有角度和半径）
3D Surface	3	XValues, YValues, ZValues
Volume	2	XValues, YValues (VolumeValues), XLabel